Kontroverse These: KI kann immer noch keine brauchbare Dokumentation schreiben. Das eigentliche Problem? Entwickler lesen ohnehin keine Dokus mehr.
Das bringt zwei bittere Wahrheiten der modernen Softwareentwicklung auf den Punkt:
1. Die Hürde bei der Dokumentationsqualität – Aktuelle LLMs tun sich schwer mit kontextbezogenen, beispielgestützten Texten, die eine Doku wirklich nützlich machen. Sie können oberflächliche API-Referenzen erstellen, versagen aber bei den Teilen à la „darum solltest du das verwenden“ und „das ist der Haken“ – genau die, die gute Dokus von bloßem Rauschen unterscheiden.
2. Das Dokumentationsparadoxon – Selbst wenn die Doku gut ist, zeigen die Nutzungsmuster, dass Entwickler zunehmend direkt zu Stack Overflow, Discord oder einfach zu einer KI wechseln. Der Wandel von der „RTFM“-Kultur hin zu „Frag die KI/Community“ ist real.
Die technische Realität: Gute Dokumentation erfordert ein Verständnis der mentalen Modelle der Nutzer, häufiger Fehlerquellen und der Architekturentscheidungen, die zum aktuellen API-Design geführt haben. Das liegt nach wie vor eindeutig im menschlichen Bereich. Aber wenn sowieso niemand liest – optimieren wir dann überhaupt das richtige Problem?
Das bringt zwei bittere Wahrheiten der modernen Softwareentwicklung auf den Punkt:
1. Die Hürde bei der Dokumentationsqualität – Aktuelle LLMs tun sich schwer mit kontextbezogenen, beispielgestützten Texten, die eine Doku wirklich nützlich machen. Sie können oberflächliche API-Referenzen erstellen, versagen aber bei den Teilen à la „darum solltest du das verwenden“ und „das ist der Haken“ – genau die, die gute Dokus von bloßem Rauschen unterscheiden.
2. Das Dokumentationsparadoxon – Selbst wenn die Doku gut ist, zeigen die Nutzungsmuster, dass Entwickler zunehmend direkt zu Stack Overflow, Discord oder einfach zu einer KI wechseln. Der Wandel von der „RTFM“-Kultur hin zu „Frag die KI/Community“ ist real.
Die technische Realität: Gute Dokumentation erfordert ein Verständnis der mentalen Modelle der Nutzer, häufiger Fehlerquellen und der Architekturentscheidungen, die zum aktuellen API-Design geführt haben. Das liegt nach wie vor eindeutig im menschlichen Bereich. Aber wenn sowieso niemand liest – optimieren wir dann überhaupt das richtige Problem?