DOCUMEN.TUM
Dokumentet var rigtigt, da det blev skrevet.
Systemet fortsatte. Teksten blev liggende.
Dokumentation ældes fra første dag.
Runtime løber foran teksten, fordi produktion kræver handling før forklaring.
Et problem rammer driften. En integration ændrer sig. En regel skal rettes. En rapport skal ud. Holdet opdaterer systemet, fordi arbejdet skal videre.
Dokumentet venter. Versionsnummeret venter. Skærmbilledet venter. Den gamle forklaring bliver stående, selv om implementeringen er rykket.
Dokumentation taber værdi, når den ikke følger samme rytme som systemet.
Arkivet afslører organisationens hukommelse.
Rod i dokumenter viser rod i ansvar.
Et projekt efterlader mapper. En kopi efterlader en ny kopi. Et bilag efterlader en uklar sandhed. Til sidst ligger forklaringen i en struktur, der selv kræver forklaring.
/Dokumenter
/Ny mappe
/Ny mappe
/System
kravspecifikation_final.docx
kravspecifikation_final_ny.docx
kravspecifikation_final_ny_2.docx
Untitled 3.docx
Untitled 4.docx
integration_old.pdf
integration_current_måske.pdf
README-kopi.md
En mappe kan være en proces. Et filnavn kan være en advarsel. En kopi kan være et beslutningsspor.
Versionshistorik er dokumentationens rygrad.
Et dokument uden versionsspor tvinger læseren til at gætte.
Læsere skal kunne se, hvad der ændrede sig, hvem der ændrede det, og hvilken del af systemet teksten dækker. Ellers bliver dokumentation til løst råd med gammelt logo.
Proces beskrevet før første driftserfaring.
Integration ændret efter leverandørskift. Dokumentet nævner stadig gammelt endpoint.
Akut produktionsrettelse. Koden opdateret. Dokumentation ikke opdateret.
Ny medarbejder læser dokumentet først. Gammel medarbejder retter forklaringen bagefter.
Et dokument uden ejer mister sandhedsværdi.
Nogen skal kunne stå på mål for teksten.
Ejerskab gør dokumentation brugbar. En ejer retter sproget, når systemet flytter sig. En ejer sletter gamle spor. En ejer skriver konsekvensen, når en regel ændres.
Uden ejer læser organisationen det samme dokument flere gange. Først som forklaring. Så som mistanke. Til sidst som arkæologi.
Hvem ved det?
Hvilken version beskriver teksten?
Hvem retter den, når systemet ændrer sig?
Dokumentation uden ejer skaber dobbeltarbejde. Først læser man teksten. Så leder man efter den person, der kan bekræfte den.