Refactor documentation

[yakky]

Description

Refactor documentation to improve:

• maintainability by keeping documentation and code in the same place
• clarity by rewording
• depth by exposing api autodoc

Temporarely targeted to #621 for easier review, to be rebased after #621 is merged

References

Fix #622

Checklist

• I have read the contribution guide
• Code lint checked via inv lint
• changes file included (see docs)
• Usage documentation added in case of new features
• Tests added

[codecov]

Codecov Report

Merging #623 into develop will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff            @@
##           develop     #623   +/-   ##
========================================
  Coverage    94.14%   94.14%           
========================================
  Files           22       22           
  Lines         1041     1041           
  Branches       137      137           
========================================
  Hits           980      980           
  Misses          23       23           
  Partials        38       38           

Flag	Coverage Δ
#unittests	94.14% <0.00%> (ø)

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 1cfb8d9...63f47e6. Read the comment docs.

[coveralls]

Coverage increased (+0.1%) to 96.74% when pulling 15a82a1 on feature/issue-622-improve-documentation into 7e9536b on feature/issue-620-admin-customization.

[protoroto]

LGTM