gecko-dev/tools/docs
Andrew Halberstadt ecf5614a49 Bug 1484691 - [doc] Don't add doctrees nested under other doctrees to the root index r=nalexander
Currently, it's possible to nest doctrees underneath one another by doing this:

    SPHINX_TREES['foo'] = 'docs'
    SPHINX_TREES['foo/bar'] = 'bar/docs'

(note: the 'bar' doctree doesn't need to be a subdir of foo and can be defined
in a completely separate moz.build)

Doing this means that the docs in 'bar' will be nested underneath the docs in
'foo' when sphinx-build ultimately runs.

This allows us to add 'bar' to foo's index, essentially making bar a subdoc of
foo.  The problem is that we also add bar's docs to the root index here:
https://searchfox.org/mozilla-central/rev/dac799c9f4e9f5f05c1071cba94f2522aa31f7eb/tools/docs/moztreedocs/__init__.py#133

The result is that the main landing page for firefox-source-docs is a big long
list of random unrelated topics. There is no organization or cohesion. By
excluding subdocs from the main index, we can start to move pages around into
some kind of organization that makes sense.

Actually moving those docs will be a lot of work, but at least this will give
us the ability.

Differential Revision: https://phabricator.services.mozilla.com/D16869

--HG--
extra : moz-landing-system : lando
2019-01-18 20:10:18 +00:00
..
moztreedocs Bug 1484691 - [doc] Don't add doctrees nested under other doctrees to the root index r=nalexander 2019-01-18 20:10:18 +00:00
Pipfile
Pipfile.lock
conf.py Bug 1479127 - Add featuregate library r=mossop,firefox-build-system-reviewers,mshal 2019-01-09 20:01:52 +00:00
index.rst
jsdoc.json
mach_commands.py