~/talk

The Story Of The Code

Talkat ACCU 2023 · 2023-04-19..04-22· [documentation, soft-skills]
slides:none on file

Argues that code is a living narrative and gives concrete examples: running create‑react‑app pulls 1589 packages and the demo project contains 1,259,920 lines of JavaScript, dependencies analyzed in a graph DB; shows Go specifics like go fmt and go lint requiring exported comments and how Unicode ToTitle behaved unexpectedly; traces messy repo history across GitHub/Bitbucket, uses unit tests and example tests as documentation, and describes an emergency no-op emergency fix that removed a session dump to stop leaking credentials.

AI-written summary · about

  1. 0:00Introduction
  2. 2:12Myth of the real programmer
  3. 9:54Code quality and responsibility
  4. 15:54Documentation myths
  5. 23:42Initial commits narrative
  6. 31:09Storytelling in software
  7. 36:06Who wrote this code
  8. 43:30Emergency fixes and debt
  9. 50:39Perfect documentation pitfalls
  10. 1:00:39Unit tests as docs
  11. 1:08:27Pull requests and archaeology
  12. 1:16:08What we learned
~/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.