Skip to content

Latest commit

 

History

History

README.md

Architecture Decision Records (ADRs)

This directory contains Architecture Decision Records (ADRs) for OSM Notes API.

What are ADRs?

Architecture Decision Records are documents that capture important architectural decisions made during the project. They help:

  • Track why decisions were made
  • Understand the context and alternatives considered
  • Share knowledge with the team
  • Avoid revisiting the same decisions

ADR Format

Each ADR follows this structure:

  • Status: Proposed | Accepted | Rejected | Deprecated | Superseded
  • Context: The issue motivating the decision
  • Decision: The decision made
  • Consequences: Positive and negative impacts
  • Alternatives Considered: Other options that were evaluated

Current ADRs

Creating a New ADR

  1. Copy Template.md to a new file: 000X-short-title.md
  2. Fill in the template
  3. Update this README with the new ADR
  4. Commit with message: docs(adr): add ADR-000X for [decision]

References