new welcome

notebooks/welcome.ipynb

@@ -6,16 +6,29 @@
    "source": [
     "# OGGM tutorials\n",
     "\n",
-    "If you are new to jupyter notebooks or to jupyterlab, we recommend to have a look at our [introduction to jupyter notebooks](https://edu.oggm.org/en/latest/notebooks_howto.html) first!\n",
+    "Welcome to the OGGM tutorials, a collection of interactive notebooks designed to guide you through glacier modelling with OGGM.\n",
     "\n",
-    "If you are reading this from our webpage (https://oggm.org/tutorials), remember that each page displayed here is in fact a jupyter notebook! You can start an interactive version of these tutorials online with [MyBinder](https://docs.oggm.org/en/latest/cloud.html) by clicking on the \"launch button\" on the top right of this page (the little rocket 🚀).\n",
+    "If you are new to Jupyter Notebooks or JupyterLab, we recommend starting with our [introduction to jupyter notebooks](https://edu.oggm.org/en/latest/notebooks_howto.html)!\n",
     "\n",
-    "⚠️ You can access various versions of these tutorials ont the web:\n",
-    "- [Stable](https://oggm.org/tutorials) (**the default**): the version of the tutorials working with the latest official release of OGGM\n",
-    "- [Development version](https://tutorials.oggm.org/master): the version of the tutorials working with the most up-to-date version of OGGM on github (unreleased)\n",
-    "- [v1.5.3](https://tutorials.oggm.org/v1.5.3/notebooks/welcome.html) (2022): legacy tutorials for the OGGM versions predating v1.6 and the mass-balance calibration overhaul.\n",
+    "If you are reading this on our website (https://oggm.org/tutorials), note that each page displayed here is in fact a Jupyter notebook. You can launch an interactive version of these tutorials online with [MyBinder or OGGM-Hub](https://docs.oggm.org/en/latest/cloud.html) by clicking the “launch” button at the top right of this page (the little rocket 🚀).\n",
     "\n",
-    "Note that you can download the notebooks for any of these versions on github by selecting a given branch: [stable](https://github.com/OGGM/tutorials/tree/stable), [master](https://github.com/OGGM/tutorials), [v1.5.3](https://github.com/OGGM/tutorials/tree/v1.5.3). Be aware of which versions you are using!"
+    "\n",
+    "```{admonition} A note on tutorial versions\n",
+    ":class: note, dropdown\n",
+    "\n",
+    "⚠️ These tutorials are available in several versions:\n",
+    "\n",
+    "- [Stable](https://oggm.org/tutorials) (**default**): compatible with the latest official OGGM release.\n",
+    "- [Development version](https://tutorials.oggm.org/master): built against the latest development version of OGGM on GitHub (may include unreleased changes).\n",
+    "- [v1.5.3](https://tutorials.oggm.org/v1.5.3/notebooks/welcome.html) (2022): legacy tutorials for OGGM versions prior to v1.6 and the mass-balance calibration overhaul.\n",
+    "\n",
+    "You can download the notebooks for any version from GitHub by selecting the corresponding branch:\n",
+    "[stable](https://github.com/OGGM/tutorials/tree/stable),  \n",
+    "[master](https://github.com/OGGM/tutorials),  \n",
+    "[v1.5.3](https://github.com/OGGM/tutorials/tree/v1.5.3).\n",
+    "\n",
+    "Please make sure you are using matching versions of OGGM and the tutorials.\n",
+    "```"
    ]
   },
   {