Re: Kernel docs: muddying the waters a bit
From: Jani Nikula
Date: Thu Mar 03 2016 - 09:03:27 EST
On Sat, 13 Feb 2016, Jonathan Corbet <corbet@xxxxxxx> wrote:
> So can we discuss? I'm not saying we have to use Sphinx, but, should we
> choose not to, we should do so with open eyes and good reasons for the
> course we do take. What do you all think?
This stalled a bit, but the waters are still muddy...
Is the Sphinx/reStructuredText table support adequate for media/v4l
documentation?
Are the Sphinx output formats adequate in general? Specifically, is the
lack of DocBook support, and the flexibility it provides, a blocker?
Otherwise, I think Sphinx is promising.
Jon, I think we need a roll of dice, err, a well-thought-out decision
from the maintainer to go with one or the other, so we can make some
real progress.
BR,
Jani.
--
Jani Nikula, Intel Open Source Technology Center