~/talk

The art and practice of documentation triage

Talkat Write the Docs Portland 2018 · 2018-05-06..05-08· [developer-experience]
slides:none on file

Concrete workflow named documentation triage organizes work: do a content audit, hunt internal wikis and support threads, tag items by value vs effort, and give honest estimates in days or sprints. Prioritize ruthlessly toward minimum viable documentation, plan "good enough", write fast, publish, and instrument feedback paths so readers act as QA. Track notes about sources and owners, push big projects toward lower effort by recruiting sales or professional services, iterate and re-evaluate.

AI-written summary · about

  1. 0:00Start
  2. 3:16WHAT IS DOCUMENTATION TRIAGE?
  3. 7:27CONTENT AUDIT EXAMPLE
  4. 9:00VALUE VS LEVEL OF EFFORT
  5. 14:37THINGS TO THINK ABOUT
  6. 23:08IDENTIFY
~/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.