Pilier 2 — documentation
La conférence sépare trois couches complémentaires :
- la documentation conserve les décisions, l'expérience normale du client, l'architecture et les raisons durables;
- les plans manuels décrivent les séquences complexes, l'exploration et les jugements visuels ou ergonomiques;
- les tests automatisés vérifient rapidement et à grande échelle des comportements reproductibles.
Une séquence mêlant travail hors ligne, reconnexion, changement de poste et reprise d'un compte se prête au manuel parce que son contexte est riche. À l'inverse, un bogue corrigé devrait idéalement devenir un test automatique qui empêche son retour.
Les plans ont été conservés dans Redmine; la documentation technique de configuration et de compilation se trouve dans GitLab. Une décision durable prise dans une tâche doit être transférée vers un wiki ou une documentation permanente. Les commentaires de code ne sont utiles que s'ils expliquent un contexte absent du code lui-même.