Formatted kernel documentation at kernel.org [LWN.net]

Formatted kernel documentation at kernel.org

Posted Oct 29, 2016 10:33 UTC (Sat) by fredrik (subscriber, #232)
Parent article: Formatted kernel documentation at kernel.org

What a difference! I'm not a kernel developer, but still this delights me. Just to use Sphinx and a good theme like Read The Docs makes me instantly want to explore the kernel documentation, even if I really don't have any special reason to do so.

Thanks for the effort! Hope all kernel hackers enjoys the change as much as I do.

to post comments

Formatted kernel documentation at kernel.org

Posted Oct 30, 2016 1:04 UTC (Sun) by cwillu (guest, #67268) [Link] (1 responses)

A bit more proof-reading would have been beneficial; there's a bunch of markdown'ish syntax things that got mangled, for instance:

The kernel parses parameters from the kernel command line up to “–”; if it doesn’t recognize a parameter and it doesn’t contain a ‘.’, the parameter gets passed to init: parameters with ‘=’ go into init’s environment, others are passed as command line arguments to init. Everything after “–” is passed as an argument to init.

where the "–"'s are supposed to be "--"'s.

Formatted kernel documentation at kernel.org

Posted Nov 4, 2016 11:06 UTC (Fri) by jani (subscriber, #74547) [Link]

I'm sure there are many, many more issues. We've had a plethora of documentation converted from DocBook and plain text to reStructuredText. We simply haven't had enough eyeballs to catch everything. But part of why this is so exciting is that the documentation is now more discoverable and accessible than before, especially for people who are not kernel developers. There's actually some positive buzz around the documentation (weird, huh?). So we'll attract more people to read the documentation and, like yourself, spot issues.

People are also asking how to help. I wrote down some notes at http://lkml.kernel.org/r/87r36ujh92.fsf@intel.com. You could add "please report issues in the documentation on linux-doc@vger.kernel.org" to the list.