index.md

Decision record template for Alexandrian pattern

Introduction

• Prologue (Summary)
• Discussion (Context)
• Solution (Decision)
• Consequences (Results)

Specifics

• Prologue (Summary)
  • Statement to summarize:
    • In the context of (use case)
      facing (concern)
      we decided for (option)
      to achieve (quality)
      accepting (downside).
• Discussion (Context)
  • Explains the forces at play (technical, political, social, project).
  • This is the story explaining the problem we are looking to resolve.
• Solution
  • Explains how the decision will solve the problem.
• Consequences
  • Explains the results of the decision over the long term.
  • Did it work, not work, was changed, upgraded, etc.