Architecture Decision Record

Active theme: Light

← dokumente

Dateinamenskonventionen

Wenn Sie Ihre ADRs als gewöhnliche Textdateien erstellen, möchten Sie vielleicht eine eigene Dateinamenskonvention für ADR-Dateien festlegen.

Wir bevorzugen eine Dateinamenskonvention mit einem bestimmten Format.

Beispiele:

  • choose-database.md

  • format-timestamps.md

  • manage-passwords.md

  • handle-exceptions.md

Unsere Dateinamenskonvention:

  • Der Name besteht aus einer Verbalphrase im Imperativ der Gegenwart. Das verbessert die Lesbarkeit und passt zu unserem Format für Commit-Nachrichten.

  • Der Name verwendet Kleinbuchstaben und Bindestriche (wie dieses Repository). Das ist ein Kompromiss zwischen Lesbarkeit und Systemtauglichkeit.

  • Die Erweiterung ist Markdown. Das kann für eine einfache Formatierung nützlich sein.