Add second video tutorial (#92)

docs/explorer.rst

@@ -53,13 +53,25 @@ If you want to run the app on your own computer, see :ref:`docker-launch` below.
   average elevation of the glaciers on the map as a function of latitude (y-axis).
 
 
-Video tutorial
---------------
+Video tutorials
+---------------
+
+Part 1: app functionalities
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 .. raw:: html
 
   <iframe src="https://player.vimeo.com/video/422776970" width="640" height="357" frameborder="0" allow="autoplay; fullscreen" allowfullscreen></iframe>
-  <p><a href="https://vimeo.com/422776970">OGGM-Edu app: World Glaciers Explorer tutorial on Vimeo</a></p>
+  <p><a href="https://vimeo.com/422776970">OGGM-Edu app: World Glaciers Explorer tutorial (part 2) on Vimeo</a></p>
+
+Part 2: example questions
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. raw:: html
+
+  <iframe src="https://player.vimeo.com/video/425084908" width="640" height="357" frameborder="0" allow="autoplay; fullscreen" allowfullscreen></iframe>
+  <p><a href="https://vimeo.com/425084908">OGGM-Edu app: World Glaciers Explorer tutorial (part 2) on Vimeo</a></p>
+
 
 Questions to explore with this app
 ----------------------------------
@@ -77,13 +89,21 @@ With this app, you can address many questions, by yourself or in class! For exam
 - Does the number of glaciers in a region always correlate with their total volume?
 - What regions are most likely to contribute to sea-level rise? Where do we
   find glaciers with ice below sea-level?
-- Where are the glaciers which are warming the fastest?
-  `why <https://fabienmaussion.info/2019/08/29/era5/>`_?
+- Where are the glaciers which are warming the fastest? Why?
 - Where are the wettest glaciers in the Himalayas? (select all Himalayan glaciers
   first, then the wettest). Can you explain why?
 - Repeat the excercise above with other regions: Greenland, the Alps, etc.
 - And many more!
 
+Resources
+---------
+
+- `Glaciers and Climate <http://www.antarcticglaciers.org/glaciers-and-climate/>`_? from `antarcticglaciers.org`_
+- `Warming trends at glaciers locations <https://fabienmaussion.info/2019/08/29/era5/>`_
+
+.. _antarcticglaciers.org: http://www.antarcticglaciers.org/
+
+
 Authors
 -------
 

docs/index.rst

@@ -28,8 +28,8 @@ on glaciology and glacial water resources for Peruvian students.
    to learn how the model works.
 
 OGGM-Edu focuses on interactive content and numerical glacier experiments.
-We do not provide much resources about fundamentals in glaciology or
-climate science: for auch textbook material, refer to the excellent
+We do not provide resources about fundamentals in glaciology or
+climate science: for good textbook material refer to
 :ref:`other_resources`, which OGGM-Edu intends to complement.
 
 .. _title_apps:
@@ -39,8 +39,8 @@ Interactive apps
 
 These interactive apps can be run on any computer with an internet connection.
 
-* :doc:`explorer`
 * :doc:`gallery`
+* :doc:`explorer`
 * :doc:`simulator`
 * :doc:`alps_future`
 
@@ -49,8 +49,8 @@ These interactive apps can be run on any computer with an internet connection.
     :hidden:
     :caption: Interactive apps
 
-    explorer.rst
     gallery.rst
+    explorer.rst
     simulator.rst
     alps_future.rst
 

docs/simulator.rst

@@ -21,23 +21,23 @@ You can start the app by clicking on this link: |badgelink|_
   The glacier simulator app runs a numerical glacier model in the background,
   using computer resources on the cloud. If several people are using the app at
   the same time, the server might become slow or unresponsive. In this case,
-  we recommend to use the app on MyBinder or (even better) locally on your
-  own computer (see below).
+  we recommend to use the app
+  `on MyBinder <https://mybinder.org/v2/gh/OGGM/glacier_simulator/master?urlpath=panel/app>`_
+  or even locally on your own computer (see :ref:`docker-launch-simulator` below).
 
-You can also start the app `on mybinder <https://mybinder.org/v2/gh/OGGM/glacier_simulator/master?urlpath=panel/app>`_
-(slightly slower in general, but a good alternative if our server is saturated).
-If you want to run the app on your own computer, see :ref:`docker-launch-simulator` below.
+Getting started with the app
+----------------------------
 
-Demo
-----
+The upper panel in the app is a guided tutorial about the app's functionalities.
+You can navigate it with the "Next" and "Previous" buttons, or use the
+"Find help here" overview.
 
-(in construction)
 
 Questions to explore with this app
 ----------------------------------
 
 With this app, you can address many questions, by yourself or in class!
-
+This list will grow in the future (documentation takes time!).
 
 Glacier shape
 ~~~~~~~~~~~~~
@@ -90,7 +90,7 @@ complex?
 
     **The lower the ELA, the larger the equilibrium glacier**. The length,
     volume or maximal thickness are not necessarily linear functions of the
-    ELA. 
+    ELA.
 
 Glacier slope
 ~~~~~~~~~~~~~
@@ -137,16 +137,11 @@ The along-slope component "pulls" the glacier downwards and the perpendicular co
 .. _antarcticglaciers.org (mass-balance): http://www.antarcticglaciers.org/glacier-processes/introduction-glacier-mass-balance
 .. _antarcticglaciers.org (glacier-flow): http://www.antarcticglaciers.org/glacier-processes/glacier-flow-2/glacier-flow
 
-Mass-balance gradient
-~~~~~~~~~~~~~~~~~~~~~
-
-(in construction)
-
 
 Authors
 -------
 
-`Patrick Schmitt <https://github.com/pat-schmitt>`_ and
+`Patrick Schmitt <https://github.com/pat-schmitt>`_ (main author) and
 `Fabien Maussion <https://fabienmaussion.info/>`_.
 
 Source code