Pascal Charest - blog d’un consultant en logiciel libre

Where Linux Kernel Documentation Hides,
By Rob Landley @ Ottawa Linux Symposium

Nice presentation about the difficulties about dynamic documentations and the interaction with {Users, Developers, Google, Indexer}. The main problems being that documentation efforts doesn’t scale and that kernel developer are not really editors. Some past decisions make it possible to push patch that will break the “make html” process and thus documentation is one of the less stable part of the “current kernel”.

Very interesting talk. Kind of pitch the incessant fight between {developper, users} blogs, wiki, static web pages, dynamic web pages, kernel mailing list, git commit messages, man pages, info pages… and the effort to normalize everything.