Messages in this thread | | | From | Jani Nikula <> | Subject | Re: Kernel docs: muddying the waters a bit | Date | Thu, 03 Mar 2016 16:03:14 +0200 |
| |
On Sat, 13 Feb 2016, Jonathan Corbet <corbet@lwn.net> 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
| |