~/talk

If It’s Not Documented, Your Project Doesn’t Exist

TalkinSpanishat PyCon US 2020 · 2020-04-15..04-23· [python]
links:none on file
slides:none on file

Argues that lack of documentation hides otherwise great projects and prescribes four concrete docs types: tutorials, how‑to guides, API reference, and architecture explanations. Recommends keeping docs alongside code in plain text under version control using reStructuredText or Markdown, generating sites with Sphinx or MkDocs and publishing on Read the Docs or GitHub Pages, and gives practical reasons (adoption, contributions, future memory) plus workable workflow practices.

AI-written summary · about

  1. 0:00Start
  2. 8:53What to Write?
  3. 9:30Tutorial
  4. 10:53Technical Reference
  5. 11:50Explanation
  6. 14:44Tools
~/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.