Cianplan

Level 6: Applied: cases, FDE scenarios, mocks · L6.5 Mocks & capstone

Writing a design doc

Write a design doc and ADRs for a real project.

13 min · Pro

What you take away

  • A design doc exists to get a decision made, so it leads with the problem and the recommendation, not with the architecture.

And 3 more inside the class, in Pro.

How the class is laid out

  1. The problem
  2. What a design doc contains
  3. ADRs: one decision each
  4. The two sentences that make a doc trustworthy
  5. Check your understanding