[Ksummit-discuss] [TECH TOPIC] kernel documentation

[Julia Lawall]

On Wed, 20 Jul 2016, Daniel Vetter wrote:

> In 4.8 we have a shiny new kernel doc toolchain:
>
> https://lwn.net/Articles/692705/
>
> I think it'd be great if interested parties (might be just a hallway
> track) sit together and figure out how to best go about converting all
> the existing docs over, and how to link it all together. I think we
> pretty much have agreement that the docbook horror show needs to die,
> but there's lots of other documentation that I think would be great to
> include in the overall (cross-linked!) kernel docs.
>
> People who would be great to be there:
> - Jon Corbet
> - Mauro Carvalho
> - Jani Nikula
> - Markus Heiser
> - maybe Grant Likely, he made noises about sphinx/rst too
>
> I think converting/polishing docs would also serve well as kernel
> newbie task in opw or gsoc or wherever, that might be another
> interested group. And anyone else who wants to convert over docs for
> their subsystem.

If anyone wants to mentor an outreachy intern on this topic, let me know.
There would be a new round of internships starting in December.

julia