---
title: "Decisions"
source: Markdown ADR (MADR)
source_url: https://github.com/adr/madr
licence: MIT
domain: engineering
subdomain: madr
date_added: 2026-04-25
---

# Decisions

For new Architectural Decision Records (ADRs), please use one of the following templates as a starting point:

* [adr-template.md](adr-template.md) has all sections, with explanations about them.
* [adr-template-minimal.md](adr-template-minimal.md) only contains mandatory sections, with explanations about them. 
* [adr-template-bare.md](adr-template-bare.md) has all sections, which are empty (no explanations).
* [adr-template-bare-minimal.md](adr-template-bare-minimal.md) has the mandatory sections, without explanations. 

The MADR documentation is available at <https://adr.github.io/madr/> while general information about ADRs is available at <https://adr.github.io/>.
