Design docs that get decisions
On This Lesson 4 topics
This lesson is planned. The outline below lists the topics it will cover. The full lesson has not been published yet.
In this lesson
write a design doc that results in a decision in one review.
Planned topics
- Start with the decision needed, the context, goals and non-goals.
- Present options with trade-offs and a recommendation tied to quality attributes.
- Name risks, open questions, and rollout and rollback plans.
- Keep it short; pre-wire reviewers; record the outcome as an ADR.
Draft outline details
Demonstration
a design doc outline: summary, decision needed, context, goals, options, recommendation, risks, rollout.
Check your understanding
What should a design doc state at the top?
Show answer
The decision needed and who decides.
Practice
Apply this lesson with the module's lab, exercises and quiz.
Marking a lesson complete is optional and you can undo it any time. Your progress stays in this browser.