Improves How to navigate page

Author: spjuhel

doc/getting-started/Guide_get_started.ipynb

@@ -5,42 +5,40 @@
    "id": "trying-bronze",
    "metadata": {},
    "source": [
-    "# Climada documentation"
+    "# How to navigate this documentation"
    ]
   },
   {
    "cell_type": "markdown",
    "id": "multiple-radical",
    "metadata": {},
    "source": [
-    "This is a short summary of the guides to help you find the information that you need to get started.\n",
-    "To learn more about CLIMADA, have a look at the [introduction](../getting-started/Guide_Introduction.ipynb). You can also have a look at the paper [repository](https://github.com/CLIMADA-project/climada_papers) to get an overview of research projects."
+    "This page is a short summary of the different sections and guides here, to help you find the information that you need to get started.\n",
+    "\n",
+    "Each top section has its own landing page, presenting the essential elements in brief, and often several subsections, which go more into details."
    ]
   },
   {
-   "attachments": {},
    "cell_type": "markdown",
-   "id": "israeli-street",
+   "id": "68085d04-e4ee-45c8-8dbb-41e35bd072a1",
    "metadata": {},
    "source": [
-    "## Installation\n",
-    "\n",
-    "The first step to getting started is installing CLIMADA. To do so you will need:\n",
+    "## Getting started\n",
     "\n",
-    "1. To get the lastest release from the git repository [CLIMADA releases](https://github.com/climada-project/climada_python/releases) or clone the project with git if you are interested in contributing to the development.\n",
-    "2. To build a conda environment with the dependencies needed by CLIMADA.\n",
+    "The [Getting started](../getting-started/index.rst) section, where you are currently, presents the very basics of climada.\n",
     "\n",
-    "For details see the [Installation Instructions](../getting-started/install.rst).\n",
+    "For instance, to start learning about CLIMADA, you can have a look at the [introduction](../getting-started/Guide_Introduction.ipynb). \n",
     "\n",
-    "If you need to run a model on a computational cluster, have a look at [this guide](../development/Guide_Euler.ipynb) to install CLIMADA and run your jobs."
+    "You can also have a look at the paper [repository](https://github.com/CLIMADA-project/climada_papers) to get an overview of research projects conducted with CLIMADA."
    ]
   },
   {
    "cell_type": "markdown",
    "id": "future-distinction",
    "metadata": {},
    "source": [
-    "## Programming in Python\n",
+    "### Programming in Python\n",
+    "\n",
     "It is best to have some basic knowledge of Python programming before starting with CLIMADA. But if you need a quick introduction or reminder, have a look at the short [Python Tutorial](../getting-started/0_intro_python.ipynb). Also have a look at the python [Python Dos and Don't](../development/Guide_PythonDos-n-Donts.ipynb) guide and at the [Python Performance Guide](../development/Guide_Py_Performance.ipynb) for best practice tips."
    ]
   },
@@ -50,26 +48,48 @@
    "metadata": {},
    "source": [
     "## Tutorials\n",
-    "A good way to start using CLIMADA is to have a look at the [Tutorials](../user-guide/index.rst). The [10 minute climada](../user-guide/0_10min_climada.ipynb) tutorial will give you a quick introduction to CLIMADA, with a brief example on how to calculate you first impacts, as well as your first appraisal of adaptation options, while the [Overview](../user-guide/1_main_climada.ipynb)  will present the whole structure of CLIMADA more in depth. You can then look at the specific tutorials for each module (for example if you are interested in a specific hazard, like [Tropical Cyclones](../user-guide/climada_hazard_TropCyclone.ipynb), or in learning to [estimate the value of asset exposure](../user-guide/climada_entity_LitPop.ipynb),...). "
+    "A good way to start using CLIMADA is to have a look at the tutorials in the [User Guide](../user-guide/index.rst). The [10 minute climada](../user-guide/0_10min_climada.ipynb) tutorial will give you a quick introduction to CLIMADA, with a brief example on how to calculate you first impacts, as well as your first appraisal of adaptation options, while the [Overview](../user-guide/1_main_climada.ipynb)  will present the whole structure of CLIMADA more in depth. You can then look at the specific tutorials for each module (for example if you are interested in a specific hazard, like [Tropical Cyclones](../user-guide/climada_hazard_TropCyclone.ipynb), or in learning to [estimate the value of asset exposure](../user-guide/climada_entity_LitPop.ipynb),...). "
    ]
   },
   {
    "cell_type": "markdown",
-   "id": "0cc77b19",
+   "id": "cd831a52-ea5f-48ee-bf6b-4a6c1a1cdf15",
    "metadata": {},
    "source": [
-    "## Documentation\n",
+    "## Contributing\n",
     "\n",
-    "You can find the documentation of CLIMADA on Read the Docs [online](https://climada-python.readthedocs.io/en/stable/index.html#). Note that the documentation has several versions: 'latest', 'stable' and explicit version numbers, such as 'v3.1.1', in the url path. 'latest' is created from the 'develop' branch and has the latest changes of the developers, 'stable' from the latest release. For more details about documentation versions, please have a look at [here](https://readthedocs.org/projects/climada-python/versions/)."
+    "If you would like to participate in the development of CLIMADA, carefully read the [Developer Guide](../development/index.rst). \n",
+    "Here you will find how to set up an environment to develop new features for CLIMADA, the workflow and rules to follow to make sure you can implement a valuable contribution!"
    ]
   },
   {
    "cell_type": "markdown",
-   "id": "growing-religious",
+   "id": "dc0f6303-e02b-429f-acc3-dd1b23d49be3",
    "metadata": {},
    "source": [
-    "## Contributing\n",
-    "If you would like to participate in the development of CLIMADA, carefully read the [Git and Development Guide](../development/Guide_Git_Development.ipynb). Before making a new feature, discuss with one of the repository admins (Now Chahan, Emmanuel and David). Every new feature or enhancement should be done on a separate branch, which will be merged in the develop branch after being reviewed (see [Checklist](../development/Guide_Review.ipynb)). Finally, the develop branch is merged in the main branch in each CLIMADA release. Each new feature should come with a tutorial and with [Unit and Integration Tests](../development/Guide_Testing.ipynb). "
+    "## API Reference\n",
+    "\n",
+    "The [API reference](../api/index.rst) presents the documentation of the internal modules, classes, methods and function of CLIMADA."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6a25d260-336f-439a-8859-00b9b4c1251d",
+   "metadata": {},
+   "source": [
+    "## Changelog\n",
+    "\n",
+    "In the Changelog section, you can have a look at all the changes made between the different versions of CLIMADA"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "efa8c4fc-706b-40e1-9567-c58dc9f59e0c",
+   "metadata": {},
+   "source": [
+    "## External links\n",
+    "\n",
+    "The top bar of this website also link to the documentation of [Climada Petals](https://climada-petals.readthedocs.io/en/stable/), the webpage of the [Weather and Climate Risk group](https://wcr.ethz.ch/) at ETH, and the official [CLIMADA website](https://climada.ethz.ch/)."
    ]
   },
   {