Docs: alle Markdown-Dokumente auf Stand v1.10.0 #9

2026-08-18T06:11:01Z

florian.wilde commented

2026-08-18 06:11:01 +00:00

Alle fünf Markdown-Dokumente durchgesehen und nachgezogen. Sie hingen unterschiedlich weit zurück:

Dokument	Stand war	Was fehlte
`ROADMAP.md`	v1.7.0	Erledigtes stand noch als Vorschlag drin
`FEATURES.md`	v1.9.0	Rückblick und Zeitleiste gar nicht erwähnt
`README.md`	v1.8.0	Vier API-Routen, halbe Projektstruktur, falsche Node-Version
`DEPLOYMENT.md`	v1.5.0	Webhooks, Sitzungsfristen, Erklärung was ein Update ist
`CLAUDE.md`	v1.5.0	Sechs Fallstricke aus den letzten Runden

ROADMAP

Vier Punkte standen noch als Vorschlag drin, obwohl sie laufen: Wochenrückblick, Zeitleiste, Aufgabensuche (v1.10.0) und Webhooks (v1.7.0). In der „Erledigt"-Tabelle fehlten v1.8.0 bis v1.10.0. Die Gliederung sprang von 1.0 auf 1.2 — repariert.

Neu ist ein Abschnitt „Aufgefallen beim Bauen" mit fünf Beobachtungen, die bisher nur in Issue-Kommentaren standen.

README

Einleitung nannte weder projektübergreifende Aufgaben noch Rückblick, Zeitleiste oder die Issue-Anbindung
Vier API-Routen fehlten: /api/activity, /api/tasks/:id/issue, /api/repositories/:id/webhook, /api/webhooks/:repositoryId
Projektstruktur zeigte ein lib/sync.ts, das längst ein Verzeichnis ist, und kannte weder tasks/ noch rueckblick/ oder verlauf/
„Getestet mit" nannte Node 26.5.0 — tatsächlich läuft 24.19.0. Die Tabelle trennt jetzt den Werkzeugstand (mit Datum) von der Aussage, wann zuletzt gegen echte Git-Systeme geprüft wurde. Das war im Juli und ist seitdem nicht wiederholt worden — die Behauptung wäre sonst zu stark gewesen.

FEATURES

Neues Kapitel 2c: Rückblick und Verlauf, mit den beiden Entscheidungen, die sonst niemand nachvollziehen kann — Kalendertage in fester Zeitzone statt „7 × 24 Stunden", und „erledigt" aus dem meta-Feld statt aus dem Anzeigetext. Das Suchkapitel deckt jetzt Aufgaben mit ab, inklusive des Hinweises auf die Ausdrucksindizes.

DEPLOYMENT

Der Abschnitt „Updates" sprang direkt ins Skript, ohne zu erklären, was ein Update überhaupt ist — genau daran ist die Rückfrage „was meinst du mit Deploy?" entstanden. Jetzt steht vorneweg, dass Git und laufende Instanz zwei Orte sind und woran man sieht, welche Fassung läuft.

Dazu ein Abschnitt zu Webhooks (setzt Erreichbarkeit voraus — ohne sie geht aber nichts verloren, der Abgleich holt es nach) und die Sitzungsfristen in der Härtungsliste.

CLAUDE.md

Sechs Fallstricke, die sonst beim nächsten Mal wieder Zeit kosten:

min-width: auto bei Flex- und Grid-Kindern — hat zweimal zugeschlagen
Die feste Zeitzone gilt auch beim Rechnen, nicht nur beim Formatieren
Dialoge müssen der Bildschirmtastatur ausweichen (visualViewport)
Ein Ausdrucksindex greift nur bei Zeichengleichheit — mit EXPLAIN nachsehen
Ein leeres Migrationsverzeichnis lässt migrate diff mit P3015 abbrechen
Eine Überlaufmessung gegen unvollständige Testdaten meldet fälschlich grün

Geprüft

Querverweise zwischen den Dokumenten aufgelöst — alle Ziele existieren
Alle in README und DEPLOYMENT genannten Umgebungsvariablen gegen Code und .env.example gehalten
API-Tabelle gegen die tatsächlich vorhandenen Routen unter src/app/api/
tsc sauber, 261 Unit-Tests grün

Reine Dokumentation — kein Code, keine Migration.

Alle fünf Markdown-Dokumente durchgesehen und nachgezogen. Sie hingen unterschiedlich weit zurück: | Dokument | Stand war | Was fehlte | | --- | --- | --- | | `ROADMAP.md` | v1.7.0 | Erledigtes stand noch als Vorschlag drin | | `FEATURES.md` | v1.9.0 | Rückblick und Zeitleiste gar nicht erwähnt | | `README.md` | v1.8.0 | Vier API-Routen, halbe Projektstruktur, falsche Node-Version | | `DEPLOYMENT.md` | v1.5.0 | Webhooks, Sitzungsfristen, Erklärung was ein Update ist | | `CLAUDE.md` | v1.5.0 | Sechs Fallstricke aus den letzten Runden | ## ROADMAP Vier Punkte standen noch als Vorschlag drin, obwohl sie laufen: Wochenrückblick, Zeitleiste, Aufgabensuche (v1.10.0) und Webhooks (v1.7.0). In der „Erledigt"-Tabelle fehlten v1.8.0 bis v1.10.0. Die Gliederung sprang von 1.0 auf 1.2 — repariert. Neu ist ein Abschnitt **„Aufgefallen beim Bauen"** mit fünf Beobachtungen, die bisher nur in Issue-Kommentaren standen. ## README - Einleitung nannte weder projektübergreifende Aufgaben noch Rückblick, Zeitleiste oder die Issue-Anbindung - **Vier API-Routen fehlten**: `/api/activity`, `/api/tasks/:id/issue`, `/api/repositories/:id/webhook`, `/api/webhooks/:repositoryId` - Projektstruktur zeigte ein `lib/sync.ts`, das längst ein Verzeichnis ist, und kannte weder `tasks/` noch `rueckblick/` oder `verlauf/` - **„Getestet mit" nannte Node 26.5.0 — tatsächlich läuft 24.19.0.** Die Tabelle trennt jetzt den Werkzeugstand (mit Datum) von der Aussage, wann zuletzt gegen echte Git-Systeme geprüft wurde. Das war im Juli und ist seitdem nicht wiederholt worden — die Behauptung wäre sonst zu stark gewesen. ## FEATURES Neues Kapitel **2c: Rückblick und Verlauf**, mit den beiden Entscheidungen, die sonst niemand nachvollziehen kann — Kalendertage in fester Zeitzone statt „7 × 24 Stunden", und „erledigt" aus dem `meta`-Feld statt aus dem Anzeigetext. Das Suchkapitel deckt jetzt Aufgaben mit ab, inklusive des Hinweises auf die Ausdrucksindizes. ## DEPLOYMENT Der Abschnitt „Updates" sprang direkt ins Skript, ohne zu erklären, **was ein Update überhaupt ist** — genau daran ist die Rückfrage „was meinst du mit Deploy?" entstanden. Jetzt steht vorneweg, dass Git und laufende Instanz zwei Orte sind und woran man sieht, welche Fassung läuft. Dazu ein Abschnitt zu **Webhooks** (setzt Erreichbarkeit voraus — ohne sie geht aber nichts verloren, der Abgleich holt es nach) und die **Sitzungsfristen** in der Härtungsliste. ## CLAUDE.md Sechs Fallstricke, die sonst beim nächsten Mal wieder Zeit kosten: - **`min-width: auto`** bei Flex- und Grid-Kindern — hat zweimal zugeschlagen - Die feste Zeitzone gilt auch beim **Rechnen**, nicht nur beim Formatieren - Dialoge müssen der **Bildschirmtastatur** ausweichen (`visualViewport`) - Ein **Ausdrucksindex** greift nur bei Zeichengleichheit — mit `EXPLAIN` nachsehen - Ein **leeres Migrationsverzeichnis** lässt `migrate diff` mit `P3015` abbrechen - Eine **Überlaufmessung gegen unvollständige Testdaten** meldet fälschlich grün ## Geprüft - Querverweise zwischen den Dokumenten aufgelöst — alle Ziele existieren - Alle in README und DEPLOYMENT genannten Umgebungsvariablen gegen Code und `.env.example` gehalten - API-Tabelle gegen die tatsächlich vorhandenen Routen unter `src/app/api/` - `tsc` sauber, 261 Unit-Tests grün Reine Dokumentation — kein Code, keine Migration.

florian.wilde added 1 commit 2026-08-18 06:11:01 +00:00

docs(roadmap): Stand auf v1.10.0 gebracht

CI / pruefen (pull_request) Canceled after 0s

Details

43a4c70053

Zuletzt angefasst bei v1.7.0. Seitdem sind drei Fassungen und vier Issues
durchgelaufen, ohne dass die Roadmap es mitbekommen haette.

Erledigt und deshalb aus den offenen Abschnitten entfernt:
Wochenrueckblick, globale Zeitleiste und die Suche ueber Aufgaben - alle
drei mit v1.10.0. Webhooks standen noch als Vorschlag drin, obwohl sie seit
v1.7.0 laufen. In der Erledigt-Tabelle fehlten v1.8.0 bis v1.10.0.

Die Nummerierung war ausserdem lueckenhaft: 1.0, dann 1.2 - der Punkt 1.1
war beim Umsetzen herausgeloescht worden. Jetzt wieder fortlaufend, und
1.0 (Rest aus v1.6.0) ist mit 1.3 zusammengefasst, weil beide dasselbe
meinten.

Neu ist ein Abschnitt "Aufgefallen beim Bauen": fuenf Beobachtungen aus der
Arbeit an v1.6.0 bis v1.10.0, die sonst nur in Issue-Kommentaren und im
Chat gestanden haetten - der abgeschnittene Anwendungsname auf schmalen
Anzeigen, die fehlenden Indizes fuer die inzwischen vier
projektuebergreifenden Seiten, der fehlende Projektfilter auf der
Zeitleiste, der offene ASVS-Punkt zu geleakten Passwoertern und die zwei
Fassungen ohne Release-Anker.

Nichts davon ist dringend; festgehalten, damit es nicht verloren geht.

florian.wilde added 1 commit 2026-08-18 06:21:11 +00:00

docs: alle Markdown-Dokumente auf Stand v1.10.0

CI / pruefen (pull_request) Canceled after 0s

Details

3617222cc1

Die Dokumente waren unterschiedlich weit zurueck: FEATURES bei v1.9.0,
README bei v1.8.0, DEPLOYMENT und CLAUDE.md noch bei v1.5.0.

**README.** Die Einleitung nannte weder die projektuebergreifenden Aufgaben
noch Rueckblick, Zeitleiste oder die Issue-Anbindung. In der API-Tabelle
fehlten vier Routen (/api/activity, /api/tasks/:id/issue,
/api/repositories/:id/webhook und der eingehende /api/webhooks/:id); die
Suche war noch als "ueber die eigenen Notizen" beschrieben. Die
Projektstruktur zeigte ein lib/sync.ts, das laengst ein Verzeichnis ist, und
kannte weder tasks/ noch rueckblick/ oder verlauf/.

Unter "Getestet mit" stand Node 26.5.0, tatsaechlich laeuft 24.19.0. Die
Tabelle nennt jetzt den Werkzeugstand mit Datum und trennt ihn von der
Aussage, wann zuletzt gegen echte Git-Systeme geprueft wurde - das war im
Juli und ist seitdem nicht wiederholt worden.

**FEATURES.** Neues Kapitel 2c zu Rueckblick und Zeitleiste, samt der beiden
Entscheidungen, die sonst niemand nachvollziehen kann: Kalendertage in fester
Zeitzone statt "7 x 24 Stunden", und "erledigt" aus dem meta-Feld statt aus
dem Anzeigetext. Das Suchkapitel deckt jetzt Aufgaben mit ab.

**DEPLOYMENT.** Der Abschnitt "Updates" sprang bisher direkt ins Skript,
ohne zu erklaeren, was ein Update ueberhaupt ist - genau daran ist die Frage
"was meinst du mit Deploy?" entstanden. Jetzt steht vorneweg, dass Git und
laufende Instanz zwei Orte sind und woran man sieht, welche Fassung laeuft.
Dazu ein Abschnitt zu Webhooks (setzt Erreichbarkeit voraus, ohne sie geht
aber nichts verloren) und die Sitzungsfristen in der Haertungsliste.

**CLAUDE.md.** Sechs Fallstricke aus den letzten Runden, die sonst beim
naechsten Mal erneut Zeit kosten - allen voran "min-width: auto" bei Flex-
und Grid-Kindern, das hier zweimal zugeschlagen hat. Ausserdem: dass die
feste Zeitzone auch beim Rechnen gilt, dass Dialoge der Bildschirmtastatur
ausweichen muessen, dass ein Ausdrucksindex nur bei Zeichengleichheit
greift (mit EXPLAIN nachsehen), dass ein leeres Migrationsverzeichnis
"migrate diff" abbrechen laesst - und dass eine Ueberlaufmessung gegen
unvollstaendige Testdaten faelschlich gruen meldet.

Geprueft: Querverweise zwischen den Dokumenten aufgeloest, alle in README
und DEPLOYMENT genannten Umgebungsvariablen gegen Code und .env.example
gehalten, API-Tabelle gegen die tatsaechlich vorhandenen Routen.

florian.wilde changed title from ~~Docs: Roadmap auf Stand v1.10.0~~ to Docs: alle Markdown-Dokumente auf Stand v1.10.0

2026-08-18 06:21:35 +00:00

florian.wilde merged commit 6c3f2d5bb6 into main

2026-08-18 06:23:05 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: florian.wilde/nebula#9