Ich hatte heute die Zeit mich tiefer mit zwei Projekte zu beschäftigen. Beide sind in der frühen Entstehungsphase, haben aber schon viel Dokumentation, weil es sich primär um Protokollstandards handelt.
Leider ist die Dokumentation zu 99% KI generiert. Im Gegensatz zu menschlicher Dokumentation ist alles sehr redundant, sehr luftig ausgeschrieben und so, dass es gut für KI Systeme zu verdauen ist, aber nicht für Menschen. Mal geht es plötzlich sehr tief ins Detail, dann wieder nicht. Es gibt keinen roten Faden, nur halbherzige Dokumentfetzen.
Nach einer halben Stunde lesen hatte ich nicht das Gefühl wirklich etwas verstanden zu haben. Weder im großen ganzen, noch im Detail.
Dafür habe ich einen tollen Ansatz von einer Kollegin bekommen: https://diataxis.fr/
Beitragsbild von Francisco De Legarreta C. auf Unsplash
