Ce site est dédié à la documentation des Architecture Decision Records (ADR) de l'Agence du Numérique en Santé (ANS). Les ADR sont des documents qui capturent les décisions architecturales importantes prises au cours du développement et de la maintenance des systèmes.
Voir le lien suivant (Modèle).
Un ADR est un document qui capture une décision architecturale importante, y compris :
- Le contexte de la décision
- Les options considérées
- La décision prise
- Les conséquences de cette décision
Les ADR sont essentiels pour :
- Maintenir la trace des décisions architecturales
- Faciliter la communication entre les équipes
- Documenter les raisons derrière les choix architecturaux
- Aider à la prise de décision future
Chaque ADR suit un format standard qui comprend :
- Une date
- Un titre descriptif
- Un contexte
- Les options considérées
- La décision
- Les conséquences
Tous les ADR sont situés dans le dossier (docs/decisions). Les ADR sont organisés chronologiquement et numérotés pour faciliter leur suivi et leur référencement.
Le site web est créé en utilisant le thème Jekyll Just the Docs. Pour que les ADR soient publiés, il faut faire une pull request vers la branche gh-pages et l'accepter.