architecture-decision-record

Maintain a collection of architecture decision record templates, examples, translations, and tool links. It explains which files to update for each contribution and how to review pull requests for completeness, consistent formatting, and relevant content.

• Add an ADR template to the collection
• Add a worked decision record example
• Update links to ADR tools and pull request checks

Write architecture decision records, short documents explaining a software design choice, its context, and its consequences. It helps decide what deserves a record, select a template, organize files, and link replacement decisions to earlier records.

• Record why a database or library was chosen
• Set up a directory for decision records
• Choose an ADR template that fits the decision