Speaker
Description
The documentation discussion at past kernel summits has been lively, so
I think we should do it again. Some topics I would bring to a session
this year would include:
-
The ongoing restructuring of the Documentation/ directory. I've been
slowly moving the architecture docs into Documentation/arch/, but
would like to do more to reduce the clutter of the top-level directory
and make our documentation tree more closely resemble the organization
of the source. -
Structure. We continue to collect documents, but do little to tie
them together into a coherent whole. Do we want to change that and,
if so, how? -
Support for documentation work. There is nobody in the community who
is paid to put any significant time into documentation, and it shows.
How can we fix that? -
Infrastructure. Sphinx brings a lot but is far from perfect; what can
we do to improve it?
Other topics will certainly arise as well.
jon
