~/talk

Graphic Relief: Beyond Flowcharts and Screenshots

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

Reorganized docs add navigation cards and a short introduction, replace dense flows with consistent metaphorical illustrations, and split tutorials so UI is isolated from business logic into modular tutorials developers can copy. Videos animate UI plus background processes. Tools are Google Docs > Markdown > GitHub, Figma for a reusable graphics library, and screen/video capture with Snagit and Filmora. Independent usability testing and a paid consultant produce empirical evidence (and one surprising miss: users never find the triangle).

AI-written summary · about

  1. 0:00Introduction
  2. 1:03From attendee to speaker
  3. 2:30First week at Ripple
  4. 4:16Learning by doing
  5. 6:03Key transformations
  6. 8:32Fixing tutorial flaws
  7. 12:45Software demos with video
  8. 14:09Better flowcharts with progressive disclosure
  9. 15:57Tools for graphics and docs
  10. 18:29Avoiding Death by PowerPoint
  11. 21:58Testing docs with users
  12. 25:52Writing engaging docs
  13. 28:41Improving docs continuously
  14. 29:26Q&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.