4 posts
Literate Programming hält Dokumentation, Tests und Implementierung synchron, indem eine Markdown-Datei zur single source of truth wird. So lässt es sich in dreißig Zeilen Python umsetzen.
Ihre Docs, Tests und Code sind drei Dateien, die dieselbe Geschichte schlecht erzählen. Sie aktualisieren die Funktionssignatur im Source. Sie vergessen das…
LLM-Konversationen enthalten Absicht, abgelehnte Alternativen und funktionierenden Code. Genau das sollte Dokumentation sein. So verwandeln Sie flüchtigen Chat in dauerhafte, durchsuchbare Docs, ohne die Erzählung zu verlieren.
Sie haben fünfundvierzig Minuten mit Claude damit verbracht, einen Retry-Circuit zu entwerfen. Sie haben die Failure Modes erklärt, exponentielles Backoff…
Literate Programming versprach, dass Code erst für Menschen und dann für Maschinen geschrieben werden sollte. Vier Jahrzehnte später schreibt fast niemand so. Hier ist, warum die eleganteste Idee der Software-Dokumentation die Art und Weise, wie wir arbeiten, nicht verändern konnte.
1984 veröffentlichte Donald Knuth einen Aufsatz, der eine radikale Umkehrung vorschlug. Programme sollten nicht für Compiler geschrieben und für Menschen…
Architektur-Dokumentation veraltet im Moment des Speicherns. So hältst du Docs ehrlich – mit Code-generierten Diagrammen, ADRs und automatisierten Architektur-Tests.
Jedes Architekturdiagramm, das ich je in einem Wiki gesehen habe, war falsch. Nicht dramatisch falsch. Einfach leise, schrittweise falsch. Der Service mit dem…