~/talk

Audience, Market, Product

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

The central claim is that documentation success follows from diagnosing three concrete things — audience, market, product — and matching content to them: start with homepage/value proposition, provide a clear hello world, then pragmatic tutorials and targeted reference. Workload scales with the fit between developer style and API design (a misfit creates the largest documentation burden), market sales model determines priorities (high-touch vs low-touch sales), and the knitting metaphor shows which scenarios require heavy versus light docs.

AI-written summary · about

  1. 0:00The secret to documentation
  2. 1:37Defining documentation types
  3. 4:18Understanding your audience
  4. 8:32The impact of the market
  5. 11:53Aligning product and users
  6. 17:47Creating a flexible plan
~/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.