~/talk

Continuous Documentation

Talkat GopherCon 2019 · 2019-07-24..07-27· [documentation]
slides:none on file

Continuous documentation treats docs as code that updates every sprint, claiming Vidcaster moved implementation notes out of a sprawling README into a versioned Docs folder with links and now reflects UI and business-rule changes as they ship. It warns against putting more than three sections in README, using vague commands like “it just works,” or cultural and gendered phrasing, and recommends automated writing checks and writing for nontechnical readers so onboarding actually succeeds.

AI-written summary · about

  1. 0:00Start
  2. 2:51Why Is It Important To Have Continues Documentation
  3. 3:23Common Pitfalls in Current Documentation Practices
  4. 5:03Can You Take Your Documentation and Give to a Non-Technical Person and Expect Them To Make Sense of It
  5. 6:26Race Related Phrases
~/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.