Re: [Ksummit-discuss] [TECH TOPIC] Documentation

Kate Stewart
2019-06-12T20:33:52Z

On Wed, Jun 12, 2019 at 9:56 AM Jonathan Corbet <corbet@lwn.net> wrote:
>
> 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?

Also, it would be great if we could talk about cleaning up the
documentation licensing, so it too can have its licenses be
automatically detected. :-)

Kate