Skip to content

Latest commit

 

History

History
38 lines (30 loc) · 1.39 KB

index.md

File metadata and controls

38 lines (30 loc) · 1.39 KB
Raw
id title sidebar_label description
adrs-overview
Architecture Decision Records (ADR)
Overview
Overview of Architecture Decision Records (ADR)

The substantial architecture decisions made in the Backstage project live here. For more information about ADRs, when to write them, and why, please see this blog post.

Records are never deleted but can be marked as superseded by new decisions or deprecated.

Records should be stored under the architecture-decisions directory.

Contributing

Creating an ADR

  • Copy docs/architecture-decisions/adr000-template.md to docs/architecture-decisions/adr000-my-decision.md (my-decision should be descriptive. Do not assign an ADR number.)
  • Fill in the ADR following the guidelines in the template
  • Submit a pull request
  • Address and integrate feedback from the community
  • Eventually, assign a number
  • Add the path of the ADR to the microsite sidebar in sidebars.json
  • Add the path of the ADR to the mkdocs.yml
  • Merge the pull request

Superseding an ADR

If an ADR supersedes an older ADR then the older ADR's status is changed to superseded by ADR-XXXX and links to the new ADR.