Codul nu explică intenția
Un repository arată ce face sistemul acum. Nu explică de ce a fost aleasă arhitectura sau ce alternative au fost respinse. Nu arată nici regulile sensibile de business și schimbările care pot fi făcute în siguranță.
Documentația minimă
Fiecare produs ar trebui să aibă o hartă de arhitectură și instrucțiuni de instalare și lansare. Mai are nevoie de inventarul integrărilor, modelul de date și variabilele de configurare. Completați setul cu proceduri de backup, revenire și un jurnal al deciziilor importante.
Documentație care rămâne vie
Documentele separate de munca zilnică se învechesc. Includeți actualizarea lor în criteriile de acceptanță. O schimbare de API nu este terminată dacă diagrama și instrucțiunile au rămas în urmă.
Ce se întâmplă la incident
În primele minute ale unui incident, echipa trebuie să știe cine răspunde de sistem și de ce depinde acesta. Trebuie să găsească logurile, să limiteze eroarea și să revină la ultima versiune stabilă.
Testul predării
Cereți unui inginer care nu a lucrat la proiect să pornească aplicația, să urmărească o tranzacție și să simuleze un rollback folosind doar documentația. Blocajele lui arată exact ce lipsește.