Skip to content

Instantly share code, notes, and snippets.

@dcomartin

dcomartin/adr.md Secret

Created August 11, 2021 21:07
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save dcomartin/eb0c375c18d4a59de4d818cbb56bd670 to your computer and use it in GitHub Desktop.
Save dcomartin/eb0c375c18d4a59de4d818cbb56bd670 to your computer and use it in GitHub Desktop.

Decision record template by Michael Nygard

This is the template in Documenting architecture decisions - Michael Nygard. You can use adr-tools for managing the ADR files.

In each ADR file, write these sections:

Title

Status

What is the status, such as proposed, accepted, rejected, deprecated, superseded, etc.?

Context

What is the issue that we're seeing that is motivating this decision or change?

Decision

What is the change that we're proposing and/or doing?

Consequences

What becomes easier or more difficult to do because of this change?

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