~/talk

Design Reviews, capturing context at speed

Talkat Write the Docs Portland 2024 · 2024-04-14..04-16· [design-collaboration]
links:none on file
slides:none on file

A design-review workflow records proposals before work starts, standardizes templates, and automates publishing so context survives autonomy and churn; teams write markdown in GitHub, render with MkDocs and mermaid JS, and use templates plus PR review. After a 12‑month rollout the system shows 500+ closed PRs and 100 contributors across 40 teams, reduces unexpected interactions and duplication, and lets junior engineers document and ship with clearer rationale.

AI-written summary · about

  1. 0:00Introduction
  2. 8:26Why docs matter
  3. 13:57Design reviews as solution
  4. 21:02Working with engineers
  5. 27:01Building the review platform
  6. 31:38Results after 15 months
  7. 34:29Q&A
~/search
type to search 6,249 conferences, 138,987 speakers and 185,172 talks
~/help
cmdctrl k
search every conference, speaker and series
/
focus the filter search
h
home
c
conferences
s
speakers
e
series
t
light / dark — the status bar button does the same
?
this help
esc
close this, then clear every filter — or just the search, while you are typing in it

Ignored while you are typing. Pages without a filter rail have no search to focus.