Dependencies must be written in topological order, or they will be fetched
from PyPI instead of the local system

This will make linking from module documentation to this page easier.

This also fixes the deposit dependency.

Related to T3172

Stargirl Flowers' guide mostly codifies what we are already do, and has
some great advice on using mocks that we should follow.

It add a lot of noise to the graph, because it depends on literally everything.

Instead of the .rst served from the _sources/ directory

The sub-toctree pages are accessibly via the main toctree,
and if we make their content hidden, they are shown as empty pages.

Instead, this makes their content visible, so they list
their children.

This commit also removes the caption.
It wasn't shown so far because the toctrees were hidden,
but now it would be, but it actually looks a little silly to have
"Contents:" in bold just after a title.

It is already referenced by a couple of pages,
but I forgot to import it.

We have two hierarchies and they didn't match before this commit.

This also keeps the root toctree shorter (2 items instead of 4)

They were only visible at the bottom of the doctree
in the sidebar.

It was decided to haveall the developer documentation in the Sphinx
doc, instead of splitting it between Sphinx and the wiki.

This commit just imports contents from the wiki pages and
reformats it in ReST, there is no change in the content.

They are polluting the doc by doubling the depth of the hierarchy
and provide no clear gain.

Also increase the depth of the generated TOC, so that we can see
the full module hierarchy instead of just the first level.

giving easy access to the data model, the SWHID specifications and the
journal specifications.

Loïc Dachary authored 4 years ago and Stefano Zacchiroli committed 4 years ago

Closes T2946

Summary: Resolves T2917

Reviewers: #reviewers, zack

Maniphest Tasks: T2917

Differential Revision: https://forge.softwareheritage.org/D4796

David Douard authored 4 years ago and Stefano Zacchiroli committed 4 years ago

Summary: this is far from sufficient, but we can improve it later.

Reviewers: #reviewers, vlorentz

Subscribers: vlorentz

Differential Revision: https://forge.softwareheritage.org/D4769