More linkref fixing

Author: spjuhel

CONTRIBUTING.md

@@ -12,7 +12,7 @@ For orientation, these are some categories of possible contributions we can thin
 * **New Modules and Utility Functions:** Did you create a function or an entire module you find useful for your work? Maybe you are not the only one! Feel free to simply raise a pull request for functions that improve, e.g., plotting or data handling. As an entire module has to be carefully integrated into the framework, it might help if you talk to us first so we can design the module and plan the next steps. You can do that by raising an issue or starting a [discussion](https://github.com/CLIMADA-project/climada_python/discussions) on GitHub.
 
 A good place to start a personal discussion is our monthly CLIMADA developers call.
-Please contact the [lead developers](https://wcr.ethz.ch/research/climada.html) if you want to join.
+Please contact the [lead developers](https://climada.ethz.ch/team/) if you want to join.
 
 ## Why Should You Contribute?
 

doc/development/Guide_CLIMADA_Development.ipynb

@@ -66,8 +66,7 @@
    "metadata": {},
    "source": [
     "## Installing CLIMADA for development\n",
-    "\n",
-    "See [Installation](install.rst) for instructions on how to install CLIMADA for developers. You might need to install additional environments contained in ``climada_python/requirements`` when using specific functionalities. Also see [Apps for working with CLIMADA](../guide/Guide_get_started.ipynb#apps-for-working-with-climada) for an overview of which tools are useful for CLIMADA developers. "
+    "\n"
    ]
   },
   {
@@ -85,7 +84,7 @@
     "- the correct sorting of imports using ``isort``\n",
     "- the correct formatting of the code using ``black``\n",
     "\n",
-    "If you have installed the pre-commit hooks (see [Install developer dependencies](install.rst#install-developer-dependencies-optional)), they will be run each time you attempt to create a new commit, and the usual git flow can slightly change:\n",
+    "If you have installed the pre-commit hooks (see [Install developer dependencies](../getting-started/install.rst#install-developer-dependencies-optional)), they will be run each time you attempt to create a new commit, and the usual git flow can slightly change:\n",
     "\n",
     "If any check fails, you will be warned and these hooks **will apply** corrections (such as formatting the code with black if it is not).\n",
     "As files are modified, you are required to stage them again (hooks cannot stage their modification, only you can) and commit again.\n",
@@ -182,8 +181,6 @@
     "\n",
     "    git checkout -b branch_name\n",
     "\n",
-    "### Follow the [python do's and don't](https://github.com/CLIMADA-project/climada_python/blob/main/doc/guide/Guide_PythonDos-n-Donts.ipynb) and [performance](https://github.com/CLIMADA-project/climada_python/blob/main/doc/guide/Guide_Py_Performance.ipynb) guides. Write small readable methods, classes and functions.\n",
-    "\n",
     "get the latest data from the remote repository and update your branch\n",
     "    \n",
     "    git pull\n",
@@ -201,7 +198,7 @@
     "    git commit -m \"new functionality of .. implemented\"\n",
     "    \n",
     "### Make unit and integration tests on your code, preferably during development\n",
-    "see [Guide on unit and integration tests](../guide/Guide_Testing.ipynb)\n"
+    "see [Guide on unit and integration tests](Guide_Testing.ipynb)\n"
    ]
   },
   {
@@ -313,7 +310,7 @@
     "    \n",
     "12) Update the `develop` branch on your local machine.\n",
     "\n",
-    "Also see the [**Reviewer Guide**](../guide/Guide_Review.ipynb) and [**Reviewer Checklist**](../guide/Guide_Review.ipynb#reviewer-checklist)!"
+    "Also see the [**Reviewer Guide**](Guide_Review.ipynb) and [**Reviewer Checklist**](Guide_Review.ipynb#reviewer-checklist)!"
    ]
   },
   {
@@ -322,6 +319,8 @@
    "source": [
     "## General tips and tricks\n",
     "\n",
+    "Follow the [python do's and don't](Guide_PythonDos-n-Donts) and [performance](Guide_Py_Performance.ipynb) guides. Write small readable methods, classes and functions.\n",
+    "\n",
     "### Ask for help with Git\n",
     "\n",
     "- Git isn't intuitive, and rewinding or resetting is always work. If you're not certain what you're doing, or if you think you've messed up, send someone a message. See also our instructions for [Development with Git](Guide_Git_Development.ipynb).\n",
@@ -442,10 +441,14 @@
   }
  ],
  "metadata": {
+  "kernelspec": {
+   "display_name": "",
+   "name": ""
+  },
   "language_info": {
    "name": "python"
   }
  },
  "nbformat": 4,
- "nbformat_minor": 2
+ "nbformat_minor": 4
 }

doc/development/Guide_CLIMADA_conventions.ipynb

@@ -133,7 +133,7 @@
     "Note that most text editors usually take care of 1. and 2. by default.\n",
     "\n",
     "Please note that pull requests will not be merged if these checks fail. The easiest way to ensure this, is to use [pre-commit hooks](Guide_CLIMADA_Development.ipynb#pre-commit-hooks), which will allow you to both run the checks and apply fixes when creating a new commit.\n",
-    "Following the [advanced installation instructions](install.rst#advanced-instructions) will set up these hooks for you."
+    "Following the [advanced installation instructions](../getting-started/install.rst#advanced-instructions) will set up these hooks for you."
    ]
   },
   {
@@ -505,7 +505,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.9.19"
+   "version": "3.12.6"
   },
   "latex_envs": {
    "LaTeX_envs_menu_present": true,

doc/development/Guide_Configuration.ipynb

@@ -439,7 +439,7 @@
    "source": [
     "### Test Configuration \n",
     "\n",
-    "The configuration values for unit and integration tests are not part of the [default configuration](#Default-Configuration), since they are irrelevant for the regular CLIMADA user and only aimed for developers.\\\n",
+    "The configuration values for unit and integration tests are not part of the [default configuration](#default-configuration), since they are irrelevant for the regular CLIMADA user and only aimed for developers.\\\n",
     "The default test configuration is defined in the `climada.conf` file of the installation directory.\n",
     "This file contains paths to files that are read during tests. If they are part of the GitHub repository, their path i.g. starts with the `climada` folder within the installation directory:\n",
     "```json\n",
@@ -509,7 +509,7 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "climada_env",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
    "name": "python3"
   },
@@ -523,7 +523,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.8.13 | packaged by conda-forge | (default, Mar 25 2022, 06:05:47) \n[Clang 12.0.1 ]"
+   "version": "3.12.6"
   },
   "vscode": {
    "interpreter": {

doc/development/Guide_Euler.ipynb

@@ -207,7 +207,7 @@
     "\n",
     "### 6. Adjust the Climada configuration\n",
     "\n",
-    "See [Adjust the Climada configuration](#3.-adjust-the-climada-configuration) above."
+    "See [Adjust the Climada configuration](#adjust-the-climada-configuration) above."
    ]
   },
   {
@@ -217,7 +217,7 @@
     "\n",
     "### 7. Run a job\n",
     "\n",
-    "See [Run a job](#4.-run-a-job) above."
+    "See [Run a job](#run-a-job) above."
    ]
   },
   {
@@ -260,9 +260,9 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "#### 2. Checkout sources \n",
+    "#### 2. Work with a different branch\n",
     "\n",
-    "See [Checkout sources](#3.-Checkout-sources) above."
+    "See [Checkout sources](#checkout-sources) above."
    ]
   },
   {
@@ -288,9 +288,9 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "#### 4. Adjust the Climada configuration\n",
+    "#### 4. Adjust configuration\n",
     "\n",
-    "See [Adjust the Climada configuration](#3.-Adjust-the-Climada-configuration) above."
+    "See [Adjust the Climada configuration](#adjust-the-climada-configuration) above."
    ]
   },
   {
@@ -358,7 +358,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "### Deinstallation"
+    "### Uninstallation"
    ]
   },
   {
@@ -468,7 +468,7 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "climada_env",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
    "name": "python3"
   },
@@ -482,7 +482,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.8.13 | packaged by conda-forge | (default, Mar 25 2022, 06:05:47) \n[Clang 12.0.1 ]"
+   "version": "3.12.6"
   },
   "vscode": {
    "interpreter": {