Welcome to lightweight ADR template, as described at Practical Engineering Management - Lightweight ADR. You can use it to create Architectural Decision Records (ADRs) - to capture important architectural decisions, their context and consequences.

<aside> ℹ️ Source of template: https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions

</aside>

****How to use it?

• Click on the name of ADR → Open to get to the detailed view
• Click on the empty table row to add a new ADR:
  1. Open in a side peek
  2. Pick template [ADR] - ADR Title
  3. Fill it in with relevant data
• If you use Notion, feel free to edit Table fields to more interactive ones (e.g., Authors, from Text to People).
• If you want to use it outside of Notion, go to the ADR template:
  1. Open in a side peek
  2. Click on three dots …
  3. Export it (e.g., to Markdown, which can be copy-pasted to Confluence and other knowledge management tools)

ADR template checklist

• [ ] In the table below, create a new entry with the use of the ADR template.
• [ ] Mark this as a draft and review with trusted colleagues.
• [ ] Assign critical reviewers to the document.
• [ ] Spark the discussion (chat, meeting) and create a dedicated RFC document for big decisions or capture comments/feedback/change requests.
• [ ] Once the final decision is made, share the final version of ADR with everyone affected by it.

ADRs

ADRs