Generierte Dateien und Source of Truth
Wie Jenna Press generierte Dateien behandelt und warum Markdown-Content die Quelle der Wahrheit bleibt.
Generiert ist erlaubt, aber nicht die editierbare Wahrheit
In Jenna Press darf eine generierte Datei existieren, weil statisches Publishing trotzdem eine praktische Brücke zwischen Quellinhalten und Runtime-Rendering braucht. Das macht die generierte Datei aber nicht zu dem Ort, an dem Redakteure arbeiten sollten.
Die Quelle der Wahrheit bleiben die Markdown-Inhalte und die Generierungslogik, die sie transformiert. Generierte Ausgabe kann aus praktischen Gründen versioniert werden, sollte aber als Ausgabe behandelt, als Ausgabe reviewed und bei Änderungen an der echten Quelle neu erzeugt werden.
Diese Unterscheidung ist wichtig, weil sie sowohl die Klarheit beim Schreiben als auch die Klarheit im Code Review schützt.