Re: [PATCH] doc: flat-table directive
From: Jonathan Corbet
Date: Fri Jul 01 2016 - 09:28:41 EST
On Fri, 01 Jul 2016 13:44:17 +0300
Jani Nikula <jani.nikula@xxxxxxxxx> wrote:
> This is also one of the reasons why I so much want to keep everything
> behind one configuration file, and build everything in the Sphinx
> toolchain. To keep it all more uniform, to not duplicate stuff, and not
> deviate to some silos like we've done in the past. I think when we have
> things working, we can add dedicated config files for the select few
> things that have additional special needs. Media is probably one of
> them. But that said, I think we should be able to keep including that to
> the main documentation build too.
So this is mostly how I see things too. But it might still be worth
thinking about whether media, in particular, is special and should be
buildable as a standalone document. I can see there may be settings
where only that is wanted.
Some sort of "only build xxx.rst and see what explodes" makefile option
also seems like a useful thing to have, just as a time saver for
developers and maintainers.
jon