~/panel

Panel discussion about documentation

on YouTube 33m
Panelat React Finland 2020 · 2020-05-28..12-02· [developer-experience]

speakers

name:Jani Eväkallio
website:https://jevakallio.dev
name:Carolyn Stransky Vohr
website:https://workwithcarolyn.com
name:Stephen Meya Kenigbolo
website:https://kenigbolo.dev
name:Margarita Obraztsova
links:none on file
name:Juho Vepsäläinen
website:https://survivejs.com
name:James Stone
links:none on file

resources

video:https://youtu.be/-7nbk_D4jOE
slides:none on file

summary

Panelists debate concrete tradeoffs not platitudes: a misleading design system in docs wastes real developer hours and is worse than none, Webpack’s docs evolve into a bestseller that fixed adoption, a tiny prototype turns README examples into runnable README demos that double as tests, and teams argue monorepo for docs eases PR-linked updates; tests and GraphQL schemas help but do not replace user-facing API and conceptual documentation.

AI-written summary · about

chapters (5)

  1. 0:00Start
  2. 0:28Panelists
  3. 1:11Is There Such Thing as Bad Documentation
  4. 11:43The Rust Programmer Manual
  5. 13:39Can Tests Take the Place of Good Documentation

related talks

~/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.