logo hsb.horse

Architecture Decision Record

ADR-Konventionen

Benennung, Sprachstrategie und Listenschema definieren.

Angenommen #docs #process

ADR-Konventionen

Entscheidung

  • docs/ADR/YYYY-MM-DD-NNN-<slug>.<lang>.md wird übernommen.
  • lang-Werte wie ja / en verwenden und künftige Erweiterungen zulassen.
  • Pro Entscheidung und Sprache jeweils eine Datei pflegen.

Kontext

Wir benötigten ein Benennungsschema, das chronologisch sortiert und die Sprachen eindeutig abbildet.

Begründung

  • Datum und Sequenz machen Chronologie und Entscheidungsnummer explizit.
  • .<lang> macht die Sprache eindeutig.
  • Kurze Slugs erhöhen die Lesbarkeit der Listen.

Konsequenzen

Erstelle je ein ja- und en-Paar mit identischem Datum und identischer Sequenz.