Version 1.7.0: Dokumentation durchgesehen, Roadmap angeglichen #18

Merged
florian.wilde merged 1 commits from docs/version-1-7-0 into main 2026-08-21 09:41:26 +00:00
Owner

Kein Issue dahinter — direkt angefragt. Deshalb ein Zweig ohne Nummer.

Zuerst: zwei falsche Aussagen

Die wiegen schwerer als jede Lücke, weil sie verbindlich klingen.

Datei Stand bisher seit
docs/anleitung.md „Statische erscheinen nicht — sie werden nicht gespeichert." falsch seit 1.5.0
docs/funktionen.md dieselbe Aussage falsch seit 1.5.0
README.md, availability.ts „In Version 1 gilt das nur für Website." falsch seit 1.1.0

Dann: die Lücken

Vorher stand jedes der sechs neuen Features nur in ein oder zwei Dateien — die Bedienungsanleitung hatte keines davon, obwohl sie das ist, was jemand beim Bedienen aufschlägt.

Feature README funktionen.md anleitung.md
Kurzhilfe Domains (#4) neu neu neu
Filter nach Art (#5) ✓ neu neu
Dublettenprüfung (#6) neu ✓ neu
Domain-Check (#7) ✓ neu neu
Logo im Code (#8) ✓ ✓ neu
Typen je Gruppe (#11) ✓ ✓ neu

Dazu im README die beiden fehlenden Routen in der Schnittstellen-Tabelle (/api/admin/domains/{id}/check, /api/domain-check).

Roadmap

  • Raus aus „Als Nächstes": QR-Typen je Gruppe und Logo im QR-Code — beide gebaut.
  • Neu aufgenommen: Gestaltung eines gespeicherten Codes ändern. Beim Einbau des Logos aufgefallen: In „Meine Codes" lässt sich die Gestaltung gar nicht mehr anfassen, ein Logo also nur über die Schnittstelle nachrüsten. Bei dynamischen Codes ist das unnötig streng.
  • Der Abschnitt „Gebaut" nennt 1.7.0.

Version

1.6.0 → 1.7.0. Additive Erweiterungen, keine Brüche — dieselbe Stufe wie 1.1.0 bis 1.6.0. Eintrag in src/lib/changelog.ts, CHANGELOG.md daraus erzeugt.

Nebenbei: Die Kurzhilfe verwies unter „Nachprüfen" noch auf curl, obwohl seit #7 der Prüfen-Knopf danebensteht.

Geprüft: Typprüfung, Linter und npm run changelog -- --check grün; die Versionsseite zeigt 1.7.0 zuoberst mit „läuft hier" (Testreihe 20 von 20).

Noch offen: Die neuen Abschnitte der Bedienungsanleitung haben keine Bildschirmfotos. docs/screenshots.mjs erzeugt sie, braucht dafür aber eine leere Instanz mit AUTH_ENABLED=true und würde alle sechzehn vorhandenen Bilder mit erneuern. Sage gern Bescheid, dann mache ich das als eigenen Durchgang.

Kein Issue dahinter — direkt angefragt. Deshalb ein Zweig ohne Nummer. ## Zuerst: zwei falsche Aussagen Die wiegen schwerer als jede Lücke, weil sie verbindlich klingen. | Datei | Stand bisher | seit | | --- | --- | --- | | `docs/anleitung.md` | „Statische erscheinen nicht — sie werden nicht gespeichert." | falsch seit **1.5.0** | | `docs/funktionen.md` | dieselbe Aussage | falsch seit **1.5.0** | | `README.md`, `availability.ts` | „In Version 1 gilt das nur für Website." | falsch seit **1.1.0** | ## Dann: die Lücken Vorher stand jedes der sechs neuen Features nur in ein oder zwei Dateien — die **Bedienungsanleitung hatte keines davon**, obwohl sie das ist, was jemand beim Bedienen aufschlägt. | Feature | README | funktionen.md | anleitung.md | | --- | --- | --- | --- | | Kurzhilfe Domains (#4) | neu | neu | neu | | Filter nach Art (#5) | ✓ | neu | neu | | Dublettenprüfung (#6) | neu | ✓ | neu | | Domain-Check (#7) | ✓ | neu | neu | | Logo im Code (#8) | ✓ | ✓ | neu | | Typen je Gruppe (#11) | ✓ | ✓ | neu | Dazu im README die beiden fehlenden Routen in der Schnittstellen-Tabelle (`/api/admin/domains/{id}/check`, `/api/domain-check`). ## Roadmap - **Raus aus „Als Nächstes":** QR-Typen je Gruppe und Logo im QR-Code — beide gebaut. - **Neu aufgenommen:** *Gestaltung eines gespeicherten Codes ändern*. Beim Einbau des Logos aufgefallen: In „Meine Codes" lässt sich die Gestaltung gar nicht mehr anfassen, ein Logo also nur über die Schnittstelle nachrüsten. Bei dynamischen Codes ist das unnötig streng. - Der Abschnitt „Gebaut" nennt 1.7.0. ## Version `1.6.0` → **`1.7.0`**. Additive Erweiterungen, keine Brüche — dieselbe Stufe wie 1.1.0 bis 1.6.0. Eintrag in `src/lib/changelog.ts`, `CHANGELOG.md` daraus erzeugt. Nebenbei: Die Kurzhilfe verwies unter „Nachprüfen" noch auf `curl`, obwohl seit #7 der Prüfen-Knopf danebensteht. Geprüft: Typprüfung, Linter und `npm run changelog -- --check` grün; die Versionsseite zeigt 1.7.0 zuoberst mit „läuft hier" (Testreihe 20 von 20). **Noch offen:** Die neuen Abschnitte der Bedienungsanleitung haben keine Bildschirmfotos. `docs/screenshots.mjs` erzeugt sie, braucht dafür aber eine leere Instanz mit `AUTH_ENABLED=true` und würde alle sechzehn vorhandenen Bilder mit erneuern. Sage gern Bescheid, dann mache ich das als eigenen Durchgang.
florian.wilde added 1 commit 2026-08-21 09:27:40 +00:00
Sechs Erweiterungen sind zusammengekommen — Logo im Code, Freigabe je
Gruppe, Domain-Check, Dublettenpruefung, Filter nach Art und die
Kurzhilfe zu den Domains. Dafuer eine neue Minor-Version.

Zwei Stellen waren schlicht falsch und wiegen schwerer als jede Luecke:
Anleitung und Funktionsuebersicht behaupteten beide noch, statische Codes
wuerden "nicht gespeichert" — ueberholt seit 1.5.0. Ebenso die Aussage,
nur "Website" sei ausprogrammiert; das gilt seit 1.1.0 fuer alle fuenfzehn.

Danach die Luecken: Jedes der sechs Features steht jetzt in allen drei
Dokumenten, die es betrifft. Die Bedienungsanleitung hatte keines davon.

Die Roadmap verliert die zwei gebauten Punkte und bekommt einen neuen aus
der Umsetzung: Die Gestaltung eines gespeicherten Codes laesst sich
ueberhaupt nicht aendern, ein Logo also nur ueber die Schnittstelle
nachruesten.

Die Kurzhilfe verwies unter "Nachpruefen" noch auf curl, obwohl seit #7
der Pruefen-Knopf danebensteht.
florian.wilde merged commit 1f4753b753 into main 2026-08-21 09:41:26 +00:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: florian.wilde/qrcode-generator#18