Development log

Was entschieden wurde, wann und warum – einschließlich der Rückgängigmachungen. Geschrieben, während die Arbeit stattfindet, weshalb sie Dinge enthält, die ein nachträglicher Bericht möglicherweise bereinigt hätte.

Das Entwicklungsprotokoll dokumentiert Entscheidungen und nicht Commits. Nicht was sich geändert hat – die Versionskontrollhistorie sagt das bereits – sondern warum es sich so geändert hat und welche Kosten die Alternative gehabt hätte.

Es wird während der Arbeit verfasst, nicht danach rekonstruiert. Das ist es, was es lesenswert macht und was es gelegentlich unbeholfen macht: die Umkehrungen sind hier ebenfalls enthalten, zusammen mit den Gründen, die sie hervorgerufen haben – einschließlich des Abends, an dem diese Projektbeschreibung selbst vor Ort neu geschrieben wurde, und nicht nachträglich unter der alten hinzugefügt.

Das Log ist eine einzige, durchgehende Datei im Repository und wird hier jährlich veröffentlicht. Die Einträge sind in umgekehrter chronologischer Reihenfolge angeordnet, jeder Eintrag ist datiert, und jedes Datum kann mit der Historie des Repositories abgeglichen werden.

docs/JOURNAL.md im öffentlichen Repository – diese Seite ist eine Kopie davon, keine Zusammenfassung.