# ADR Writing — Resources

## Foundational Articles

- [Documenting Architecture Decisions](https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions) — Michael Nygard's original ADR article.
- [ADR GitHub Organisation](https://adr.github.io) — ADR formats, templates, and tools.
- [MADR (Markdown ADR)](https://adr.github.io/madr/) — Lightweight, Markdown-based ADR template.

## Guides and Examples

- [Architecture Decision Records (Nat Pryce)](https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions) — Context and motivation.
- [ADR Examples — Joel Parker Henderson](https://github.com/joelparkerhenderson/architecture-decision-record) — Large collection of ADR examples.
- [Think Before You Leap — Thomas Guest](https://tomguest.net/writing/think-before-you-leap/) — When and how to use ADRs.

## Tooling

- [adr-tools](https://github.com/npryce/adr-tools) — Command-line tool for managing ADRs.
- [Log4brains](https://github.com/thomvaill/log4brains) — Web-based ADR catalog with Git integration.
- [adr-manager](https://github.com/adr/madr) — MADR format and tooling.

## Books and Longer Reads

- **Documenting Software Architectures** by Bass, Clements, Kazman — Broader documentation context.
- [Martin Fowler — Architecture Guide](https://martinfowler.com/architecture/) — Architecture documentation practices.

## Videos

- [YOW! — Documenting Architecture Decisions](https://www.youtube.com/results?search_query=ADR+architecture+decision+record) — Conference talks on ADRs.
- [InfoQ — ADR in Practice](https://www.infoq.com/) — Search for "architecture decision record" talks.