What kernel documentation could be
summary
Kernel documentation is a big messy pile that needs reorganization by audience, not author: propose a redesigned front page (current printout is 26 sheets) that separates developers vs users, surfaces getting-started guides per subsystem, and links docs to specific git files; keep human-readable source as plain text rst rendered by Sphinx, avoid auto-generating prose, collect visit stats, involve ELISA/mentors and tech writers, and rely on maintainers to review contributions.
AI-written summary · about
chapters (7)
- 0:00Introduction to kernel docs
- 3:22Current documentation state
- 7:54Organizing by audience
- 14:42Security documentation gaps
- 22:32Tribal knowledge transfer
- 30:23Getting started guides
- 36:22Community feedback and next steps
related talks
41mKernel documentation: update and future directions
59mA kernel documentation update
26mEvolution of Product Documentation
53mDocumenting the Design of the Linux Kernel
32mBridge the Gap To OSS Adoption With Documentation: A Kubernetes Story
33mWhat The Doc?!?! How to Write and Read Documentation That Allows You To Get Sh*t Done!
01h 24mWriting Documentation - Practices and Theory
46mSave a Dev, Write Documentation!