This has been broken [1] for a while.

[1] https://jenkins.softwareheritage.org/view/swh-draft/job/DDOC/job/dev/311/

Related to T3780

Related to T3717

Closes T3737

the 'architecture' section has a bunch of items not useful to newcomers
(Keycloak, mirroring, ...)

Related to T3621

Related to T3154

Related to T3154

This moves the dns setup out of the networking page into its own section.

Related to T3154

This splits the existing pages into multiple ones:

- (new) reference-setup.rst: This is the main page filled in with the existing one
- (update) howto-test-changes-in-vagrant.rst: reference link got updatee to the current
  readme section)
- (update) howto-manage-third-party-modules.rst: coming from the main page with links
  broken fixed
- (update) howto-deploy-puppet-change.rst: coming from main page with links broken fixed
- (update) tutorial-my-first-change-in-puppet.rst: With some actual updates on how to
  develop, diffing and asking for review.

Related to T3154

Related to T3154

Related to T3154

This splits the upgrade swh services from the intranet page in 2 distincts
documentation.

Related to T3154

The default credentials for dell and supermicro have been installed in the creds store.

Related to T3154

There is no need for it here. This keycloak doc is about its use, not really an
architecture page.

Also, it's currently failing the docs dev build.

[1] https://jenkins.softwareheritage.org/view/swh-draft/job/DDOC/job/dev/6866/console

Related to T3154

This also:
- installs redirection from old location to the new one.
- install the intended audience on respective documentations.

Related to T3154

This also installs the intended audience on documentation.

Related to T3154

This also:
- installs redirection from old location to the new one.
- install the intended audience on respective documentations.

Related to T3154

- update the global infrastructure schema
- update the service urls

Related to T3630

As the toctree for the faq was included multiple times in index file,
the associated menu entry in the sidebar was not properly rendered.

In order to workaround the issue, ensure faq toctree is included once
in the index file and add reference to faq page in Getting started
top level section.

Also as faq subsection entries are no longer included in the sidebar
menu, display a local toctree at the top of the faq page.

Closes T3657

Related to T3154

Related to T3154

This fixes some trailing whitespaces and errors detected by codespell.

The encountered issues have been fixed in release 1.8.0 of
sphinxcontrib-httpdomain.

That creates warning as well thus failing the build.

Related to T3648

This also adds a redirection from the old path "users" to the new one "user".

Related to T3650

Related to T3658

Related to T3648

underscore-backtick was used instead of backtick-underscore to terminate links,
which is invalid rst syntax