Skip to content

Add adr.zone to tooling list (any template)#100

Open
bnunamak wants to merge 1 commit intoadr:mainfrom
bnunamak:add-adr-zone
Open

Add adr.zone to tooling list (any template)#100
bnunamak wants to merge 1 commit intoadr:mainfrom
bnunamak:add-adr-zone

Conversation

@bnunamak
Copy link
Copy Markdown

Adds adr.zone to the "Tooling to create and maintain decision files (Any template)" section.

adr.zone is a free web-based ADR generator with multi-format support (Nygard, MADR, Y-Statement, ISO/IEC/IEEE 42010-inspired), examples, and a simple API for programmatic ADR generation.

Let me know if you'd prefer different wording or placement!

@bnunamak
Copy link
Copy Markdown
Author

bnunamak commented May 8, 2026

Hey @koppor ,

wondering if there's anything I can help with to getting this closer to merge?

The main value adds (in my opinion) of adr.zone are:

  • Callable ADR generation HTTP REST API (I use this a lot informally with my own agents)
  • Browser-based generator with shareable URLs
  • Introduced an "Outcome First" ADR variant for improved async comms more towards org leadership and higher-level stakeholders. It presents outcomes / decisions / impact before technical reasoning for scanning. Based loosely around outcome-first communication principles applied to ADRs for ongoing ops

Really appreciate you maintaining this ADR hub and would love to support you more outside of this where possible!

@koppor
Copy link
Copy Markdown
Member

koppor commented May 8, 2026

Thank you for submitting and pinging.

I am on the train, cannot click any link. No screenshots found in the PR. Too much hazzle for me to manually open the web page and check. Will do as soon as I find time.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants