Engineering Decision Record (EDR)

A standard form to propose and record changes to engineering practices, inspired by Architecture Decision Records (ADRs). Easily capture relevant information and create a historical record of why things are the way they are.
About this template

Projects grow and evolve, and many decisions are made over time that affect the engineering practices at play. Often these decisions are made on the fly, and gradually the context and details of the decisions are lost as memories fade and people leave. We’re left doing things a certain way because “that’s the way we do things”.

Occasionally a person may wonder why we do things the way we do. "Without understanding the rationale or consequences, this person has only two choices: blindly accept the decision, or blindly change it." ([Documenting Architecture Decisions](https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions))

This is not a great state of affairs. Having a standard process for proposing and adopting engineering improvements makes it easier to drive positive change. The Engineering Decision Record (EDR) is a lightweight way to do just that.

Categories
About this creator

More like this

Related content

Visit Help Center