On Jenkins, Phabricator repository callsign is used as source directory
instead of the short name.

Elasticsearch is required to work on swh-search component.

Related to T3460

Related to T3374

While T735 is the upper level task, that might make curious people follow through too
much indirection. So simplifying to target directly the interesting and up-to-date task.

Related to T3374

Related to T3374

There is no reason to filter out these warnings only in tox builds
as the issue comes from upstream httpdomain not in sync with latest
sphinx API.

It also enables to unstuck swh-web and swh-docs builds on Jenkins.

Since the release of sphinx 4.1, a new warning related to httpdomain
extension appeared when buidling swh-web documentation.

It is not critical and is due to httpdomain not in sync with latest
changes in sphinx, so filter out that warning as it makes sphinx
builds fail for swh-web on Jenkins.

The following document demonstrates how to create a new swh package in the current swh
phabricator instance and reference it so the Continuous Integration (CI) is able to
build the new module.

Related to T3179

So it's integrated in the build.

Related to T2845

It's not working with the default plantuml version installed
with debian buster (1.2018.13)

Similarly to what the previous commit did to the developer doc

The FAQ was put in a single file in faq/faq.rst as a hack, using
multiple top-level headers in the same file to make them appear
in the global TOC.

With this change, the TOC is moved to the index.rst file, with
a single top-level header, and uses a local TOC instead, as it
should be.

Additionally, this removed the manually-written TOC in the main
index to use an auto-generated one.

Related to T3388

This opens the users faq we short-listed during the documentation sprint. Question are
regrouped under a specific category.

Categories are listed from the main page and from the left menu.

Related to T3388

This opens the developers faq we short-listed during the documentation sprint. Question
are regrouped under a specific category.

Categories are listed from the main page and from the left menu.

Related to T3119

Related to T3388

Related to T3119

Previous values did not prevent sphinx-apidoc to walk the content
of these directories resulting in really long processing when
directories contain a lof of entries (node_modules for instance).

fix the jenkins build (dev)

Related to T3203

initiate an infrastructure section and a network sub-section

Remark: the png of the plantuml diagram is committed because
the svg in not correctly rendered

Related to T3203

This fixes an import error during sphinx-apidoc processing.

It's needed by the ci to be able to reference the api links

Related to T3307

The first two redirect, the last one is broken.

As it was, it was unclear that it linked to the documentation of internal
Python module, instead of the public HTTP API.

Phabricator short code is used as folder name instead of project name
in that case.

Related to T3258