At noen andre enn de som bygget systemet, kan forstå, drifte og videreutvikle det.
Hvorfor det er viktig
Udokumenterte systemer har en skjult eier: utvikleren som husker hvordan det henger sammen. Den dagen vedkommende slutter, faller verdien av systemet dramatisk.
Eksempel på kravformulering
Leverandøren skal levere oppdatert dokumentasjon av arkitektur, datamodell, integrasjoner, miljøoppsett og driftsrutiner. Dokumentasjonen skal versjoneres sammen med koden og være tilstrekkelig til at en kvalifisert tredjepart kan overta drift og videreutvikling.
Tilpass tallene til deres virkelighet — et krav du ikke kan begrunne, er et krav du ikke bør stille.
Slik verifiserer du det
Den ærlige testen: la en utvikler som ikke kjenner systemet, sette det opp lokalt kun ved hjelp av dokumentasjonen. Klarer de det ikke, er den ikke god nok.
Fallgruver
Å kreve «god dokumentasjon» uten å definere hva det betyr — da får dere en mappe med utdaterte Word-filer. Krev heller at den ligger med koden og oppdateres i samme endring.
AI-perspektiv
AI kan generere og vedlikeholde teknisk dokumentasjon rimelig effektivt — men den kan bare beskrive hva koden gjør, ikke hvorfor valget ble tatt. Begrunnelsene må mennesker skrive.