Page MenuHomeSoftware Heritage

make-doc: use the docs-assets target instead of the full-sphinx-build docs
ClosedPublic

Authored by douardda on Nov 12 2018, 2:27 PM.

Details

Summary

so we do not build each swh-* twice with unavaoidable sphinx wrnings when
building each repo locally.

also add an hidden toctree entry to ensure swh-*/index.rst are properly referenced

and thus prevent sphinx from complaining about rst files not being included in
a toctree without having to insert :orphan: everywhere.

Diff Detail

Repository
rDDOC Development documentation
Lint
Automatic diff as part of commit; lint not applicable.
Unit
Automatic diff as part of commit; unit tests not applicable.

Event Timeline

ardumont added a subscriber: ardumont.
ardumont added inline comments.
docs/index.rst
121 ↗(On Diff #2021)

you mean does not complain too much, don't you?

This revision is now accepted and ready to land.Nov 12 2018, 2:59 PM
douardda marked 2 inline comments as done.

fix typo in comment

docs/index.rst
121 ↗(On Diff #2021)

I do indeed

This revision was automatically updated to reflect the committed changes.