Adds some near final touch

Author: spjuhel

CONTRIBUTING.md

@@ -16,7 +16,7 @@ Please contact the [lead developers](https://climada.ethz.ch/team/) if you want
 
 ## Why Should You Contribute?
 
-* You will be listed as author of the CLIMADA repository in the [AUTHORS](#authors) file.
+* You will be listed as author of the CLIMADA repository in the [AUTHORS](authors) file.
 * You will improve the quality of the CLIMADA software for you and for everybody else using it.
 * You will gain insights into scientific software development.
 
@@ -40,7 +40,7 @@ To contribute follow these steps:
     ```bash
     pylint
     ```
-6. Add your name to the [AUTHORS](AUTHORS.md) file.
+6. Add your name to the [AUTHORS](authors) file.
 7. Push your updates to the remote repository:
 
     ```bash
@@ -84,3 +84,4 @@ It also contains a checklist for both pull request authors and reviewers to guid
 [docs]: https://climada-python.readthedocs.io/en/latest/
 [devguide]: https://climada-python.readthedocs.io/en/latest/#developer-guide
 [testing]: https://climada-python.readthedocs.io/en/latest/development/Guide_Testing.html
+[authors]: https://github.com/CLIMADA-project/climada_python/blob/main/AUTHORS.md

doc/api/index.rst

@@ -2,7 +2,8 @@
 API Reference
 ==============
 
-Could be nice to have an API section homepage
+The API reference contains the whole specification of the code, that is, every modules,
+classes (and their attributes), and functions that are available (and documented).
 
 .. toctree::
    :caption: API Reference

doc/development/index.rst

@@ -1,12 +1,12 @@
-.. include:: ../misc/CONTRIBUTING.md
+.. include:: ../../CONTRIBUTING.md
    :parser: myst_parser.sphinx_
 
 .. toctree::
    :maxdepth: 2
    :hidden:
 
-   Developer guide <Guide_CLIMADA_Development>
-   Development with Git <dev-git>
+   Overview <Guide_CLIMADA_Development>
+   Developing with Git <dev-git>
    Coding in python <coding-in-python>
    CLIMADA Coding Conventions <Guide_CLIMADA_conventions>
    CLIMADA Configuration convention <Guide_Configuration>

doc/misc/AUTHORS.rst

@@ -0,0 +1,2 @@
+.. include:: ../../AUTHORS.md
+   :parser: myst_parser.sphinx_