Apply suggestions from code review

Co-authored-by: Lukas Riedel <34276446+peanutfun@users.noreply.github.com>

Author: spjuhel

AUTHORS.md

@@ -1,4 +1,3 @@
-(authors)=
 # CLIMADA List of Authors
 
 * Gabriela Aznar-Siguan

doc/development/dev-git.rst

@@ -4,7 +4,6 @@ Using git and GitHub to develop
 
 .. toctree::
    :maxdepth: 1
-   :hidden:
 
    Development with Git <Guide_Git_Development>
    Guide_continuous_integration_GitHub_actions

doc/development/index.rst

@@ -1,9 +1,13 @@
+***************
+Developer Guide
+***************
+
 This developer guide regroups all information intended for contributors.
 
 Very minimal instruction for contributing can be found below.
 
 If you are interested in contributing to Climada, we recommand you to start with the
-`Overview <Guide_CLIMADA_Development>` part of this guide.
+:doc:`Overview <Guide_CLIMADA_Development>` part of this guide.
 
 .. include:: ../../CONTRIBUTING.md
    :parser: myst_parser.sphinx_

doc/getting-started/index.rst

@@ -21,6 +21,8 @@ You are good to go!
 
    You don't have mamba or conda installed or you are looking for advanced installation instructions? Look up our :doc:`detailed instructions <install>` on CLIMADA installation.
 
+Climada in a Nutshell
+---------------------
 
 .. dropdown:: How does CLIMADA compute impacts ?
    :color: primary
@@ -107,5 +109,4 @@ You are good to go!
    Navigate this documentation <Guide_get_started>
    Introduction <Guide_Introduction>
    Installation instructions <install>
-   How to cite CLIMADA <../misc/citation>
    Python introduction <0_intro_python>

doc/index.rst

@@ -28,6 +28,8 @@ adaptation options. Modules for generating different types of hazards and other
 specialized applications can be found in the `CLIMADA Petals
 <https://climada-petals.readthedocs.io/en/stable/>`_ module.
 
+**Useful links:** `WCR Group <https://wcr.ethz.ch/>`_ | `CLIMADA Petals <https://climada-petals.readthedocs.io/en/stable/>`_ | `CLIMADA website <https://climada.ethz.ch>`_ | `Mailing list <https://sympa.ethz.ch/sympa/info/climada-users>`_
+
 .. grid:: 1 2 2 2
     :gutter: 4
     :padding: 2 2 0 0
@@ -136,6 +138,3 @@ specialized applications can be found in the `CLIMADA Petals
    Developer Guide <development/index>
    API Reference <api/index>
    Changelog <misc/CHANGELOG>
-   CLIMADA Petals <https://climada-petals.readthedocs.io/en/stable/>
-   WCR Group <https://wcr.ethz.ch/>
-   CLIMADA Website <https://climada.ethz.ch>