6 posts
Literate Programming verspricht eine einzige Quelle der Wahrheit, aber manuelle Weave- und Tangle-Schritte brechen die CI/CD-Pipeline. So automatisieren Sie Extraktion und Dokumentationsgenerierung, damit Ihre Markdown-Dateien kanonisch bleiben.
Wenn Ihre Build-Pipeline nicht laufen kann, ohne dass Sie ein Terminal öffnen und eintippen, haben Sie kein literates Programm. Sie haben ein Tagebuch mit…
Ich verbrachte 30 Tage damit, Design-Erklärungen zu schreiben, bevor ich ein LLM um Code bat. Die Ergebnisse veränderten meine Sicht auf Rubber-Ducking.
Die meisten Entwickler nutzen LLMs rückwärts. Wir beschreiben in fünf Wörtern, was wir wollen, bekommen 200 Zeilen Code zurück und verbringen die nächste…
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…
Jeder Compiler sieht deinen Code als Baum, aber dein Editor lässt dich rohen Text bearbeiten. So sieht strukturiertes Editieren tatsächlich aus, warum es sich nicht durchgesetzt hat und wie du seine Vorteile nutzen kannst, ohne Tools zu wechseln.
Jede Programmiersprache hat eine formale Grammatik. Dein Compiler liest sie, baut einen Parse-Tree auf und verwirft alles, was nicht passt. Dein Editor…
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…