20 years with DocBook
summary
PostgreSQL’s documentation team describes maintaining over 2,000 printable pages of docs in DocBook for twenty years, focusing on tooling challenges: build-time limits and performance for very large outputs, and the need for long-term, portable toolchains so documentation can be rebuilt and patched years later. The talk discusses how DocBook has met those needs while causing struggles (for example delaying inclusion of graphics) and raises concerns about future tooling longevity and portability.
AI-written summary · about
related talks
44mPushing documentation (so it doesn't hurt anymore)
32mAbundant with life: docs beyond the wall
41mLong-term Documentation Maintenance
45mDocs or it didn't happen!
30mTechnical Documentation
25mBuilding Docs like Code: Continuous Integration for Documentation
33mDocumentation for OpenPrinting projects
50mContinuous and Automated Documentation Docs As Code in Practice