Abundant with life: docs beyond the wall
summary
Docs are living systems, not flat walls of text, and authoring choices shape contribution rates: developer-centric git workflows cut non-developer contributors, while reactive toolchains increase interactivity and findability. Mentions of DocBook, reStructuredText/Sphinx, Asciidoc and Markdown lead to a focus on Markdoc as an authoring framework (open‑sourced by Stripe) that treats docs like queryable data and integrates with React. The key claim is that removing the wall between developer and authoring experience grows participation, memory and maintainability through intentional infrastructure and caregiving practices.
AI-written summary · about
chapters (5)
- 0:00Introduction and personal journey
- 3:57Tools and markup languages
- 17:15The wall of confusion
- 23:00Documentation as living organisms
- 27:37Seed soil and growth
related talks
45mDocs or it didn't happen!
35mThe practical implementation of Documentation as Code
47mEngineering Documentation
44mPushing documentation (so it doesn't hurt anymore)
50mContinuous and Automated Documentation Docs As Code in Practice
47mDocumentation as code (explained to my dad)
56mEffective Documentation: The Key to Open Source Growth
39mDevelopers Documentation: your hidden strength