logo hsb.horse

Architecture Decision Record

Conventions ADR

Définir la convention de nommage, la stratégie de langue et le schéma de listing.

Accepté #docs #process

Conventions ADR

Décision

  • Adopter docs/ADR/YYYY-MM-DD-NNN-<slug>.<lang>.md.
  • Utiliser des valeurs lang comme ja / en, avec la possibilité d’ajouts futurs.
  • Conserver un fichier par décision et par langue.

Contexte

Nous avions besoin d’une convention de nommage qui trie chronologiquement et qui mappe clairement les langues.

Justification

  • La date et la séquence rendent la chronologie et le numéro de décision explicites.
  • .<lang> explicite la langue.
  • Des slugs courts améliorent la lisibilité des listes.

Conséquences

Créer des fichiers ja et en appariés avec la même date et la même séquence.