feat: generate docs using rtd

[PaulFarault]

Sphinx can understand Google style docstrings.

Theme is now read the docs.

Content has been splited between sources and build.

Which issue(s) this PR fixes

Fixes #330

Additional comments

• Sphinx can understand Google style docstrings.
• Theme is now read the docs.
• Content has been splited between sources and build.

Agreements

• I hereby declare this contribution to be licensed under the Apache License Version 2.0, January 2004.
• I hereby agree to grant TOSIT a copyright license to use my contributions.

[rpignolet]

Why content has been splited between sources and build ?

[PaulFarault]

@rpignolet build was there before, it's the output of the html build. sources gather the rst which were before mixed with the rest, it feels cleaner that way and it follows the RTD tutorial's project structure.

[mdrutel]

Hi,

sphinx==4.5.0
sphinx_rtd_theme==1.2.2

I have multiple warnings when I try to make latexpdf :

WARNING: l'entrée html_static_path '_static' n'existe pas
[...]
/home/mdrutel01/projets/git/tdp-ops/tdp/tdp-lib/docs/source/developer/core/index.rst:4: WARNING: toctree contains reference to nonexisting document 'developer/core/dag'
/home/mdrutel01/projets/git/tdp-ops/tdp/tdp-lib/tdp/core/collection.py:docstring of tdp.core.collection.Collection.dag_directory:1: WARNING: description dupliquée pour l'objet tdp.core.collection.Collection.dag_directory; l'autre instance se trouve dans tdp.core, utilisez :noindex: sur l'une d'elles
/home/mdrutel01/projets/git/tdp-ops/tdp/tdp-lib/tdp/core/collection.py:docstring of tdp.core.collection.Collection.dag_yamls:1: WARNING: description dupliquée pour l'objet tdp.core.collection.Collection.dag_yamls; l'autre instance se trouve dans tdp.core, utilisez :noindex: sur l'une d'elles
[...]
La compilation a réussi, 45 avertissements.

Do we need to fix these ?

[PaulFarault]

Most of them were there before. They are related to the writing of the doc, imo we need to fix them while rewriting the doc in another PR!