Diátaxis ist ein angenehm nüchternes Framework für Softwaredokumentation: https://diataxis.fr/

Die Grundidee ist simpel, aber extrem nützlich. Doku ist nicht gleich Doku.

• Tutorials zum Lernen
• How-to Guides für konkrete Ziele
• Explanation fürs Verstehen
• Reference zum Nachschlagen

Wenn man diese Typen sauber trennt, wird Doku sofort besser. Weniger Mischmasch, weniger "warum steht das hier?".

Relevant "Die Kunst der technischen Dokumentation": https://engineeringkiosk.dev/episodes/125