Architecture Decision Record

By Thomas Bracher

Context

When no documentation is available:

  1. Blindly accept it
  2. Blindly change it

[Insert sad panda gif]

Decision

Store decisions in simple text files

  • Title
  • Context
  • Decision
  • Status
  • Consequences

Status: Pending

Consequences

  • Motivation of important decision visible
  • Show effect of decisions on project
  • Maintain status of decisions

Examples

  • Migration to AWS: ops, dev, etc.
  • Framework choice for compilation
  • Dependency injection practice change

Alternatives

Repo of alternatives

Micro services oriented, business plan oriented

Merci de votre attention!

Bibliography