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

Formatted kernel documentation at kernel.org

Posted Oct 30, 2016 1:04 UTC (Sun) by cwillu (guest, #67268)
In reply to: Formatted kernel documentation at kernel.org by fredrik
Parent article: Formatted kernel documentation at kernel.org

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.

to post comments

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.