9-11 September 2019
Europe/Lisbon timezone

Kernel documentation

10 Sep 2019, 17:00
45m
Floriana/room-III (Corinthia Hotel Lisbon)

Floriana/room-III

Corinthia Hotel Lisbon

100
Kernel Summit talk Kernel Summit Track

Speaker

Jonathan Corbet (Linux Plumbers Conference)

Description

What could be more fun than talking about kernel documentation? Things we
could get into:

  • The state of the RST transition, what remains to be done, whether it's
    all just useless churn that makes the documentation worse, etc.

  • Things we'd like to improve in the documentation toolchain.

  • Overall organization of Documentation/ and moving docs when the need
    arises. It seems I end up fighting about this more than just about
    anything else, but I think it's important to organize our docs for the
    convenience of the people using them.

  • The ultimate vision for kernel docs (for now). RST conversion and
    imposing some organization are important, but they will not,
    themselves, give us a coherent set of documentation. What can we do to
    have documentation that is useful, current, and maintainable, rather
    than the dusty attic we have now?

I agree to abide by the anti-harassment policy Yes

Primary author

Jonathan Corbet (Linux Plumbers Conference)

Presentation Materials