Add SERC activities and restructure a bit (#154)

docs/classes_howto.rst

@@ -10,14 +10,33 @@ the fundamentals and online textbook materials.
 
 Currently, we are working on making OGGM-Edu suitable for classes at the
 high school level (using the web applications) and at the university level
-(using the programmable notebooks). You will find some help to get you started
-below.
+(using the web applications and the programmable notebooks).
 
-Using the OGGM-Edu web apps at the high school level
-----------------------------------------------------
+You will find some help to get you started below!
 
-OGGM-Edu can be used to organize a 2 to 4 hours class, possibly even
-longer. It could be organized as such:
+.. admonition:: New since June 2022! Teaching materials for your glaciology labs
+
+   We recently created two activities based on the OGGM-Edu web apps that
+   are suitable for high-school or university students with no previous
+   knowledge about glaciers. These activities have been tested in class and
+   provide a well defined activity schedule and instructor materials.
+   Check them out on the SERC platform:
+
+   - `OGGM-Edu Glaciology Lab 1 - What Makes a Glacier?`_
+   - `OGGM-Edu Glaciology Lab 2 - Exploring glacier data`_
+
+.. _OGGM-Edu Glaciology Lab 1 - What Makes a Glacier?: https://serc.carleton.edu/teachearth/activities/250452.html
+.. _OGGM-Edu Glaciology Lab 2 - Exploring glacier data: https://serc.carleton.edu/teachearth/activities/250446.html
+
+Using the OGGM-Edu web apps in high school
+------------------------------------------
+
+The OGGM-Edu web apps are well suited for high-school activities.
+See for example this
+`blog post by PhD students Lilian Schuster and Zora Schirmeister <https://oggm.org/2021/10/04/erasmus-project-obergurgl/>`_
+about the 3-day long excursion they organized for a class, with help of OGGM-Edu.
+
+The apps are meant to be used in order:
 
 1. General introduction to glaciers: what is a glacier, where do we find them,
    why are they important?
@@ -30,57 +49,49 @@ longer. It could be organized as such:
    be complemented with a `glacier goo <https://www.youtube.com/watch?v=DUdeN5CpsW0>`_
    experiment.
 
+See also the two OGGM-Edu lab activities hosted on SERC:
 
-Using the OGGM-Edu notebooks at the university level
-----------------------------------------------------
-
-We use notebooks frequently for our own `lectures <https://fabienmaussion.info/teaching/>`_,
-and we are big fans! They allow to convey knowledge in interactive,
-"try as you learn" practicals, and they encourage active learning.
-
-Here are a few recommendations based on our own experience:
-
-**Spend at least two hours explaining the notebook and jupyterlab environments**.
-Showing their basic features first, then let the students play with a simple and
-short notebook. In a second session (after an hour or so),
-summarize the usual pitfalls:
+- `OGGM-Edu Glaciology Lab 1 - What Makes a Glacier?`_
+- `OGGM-Edu Glaciology Lab 2 - Exploring glacier data`_
 
-- recognize that notebooks are actual files (not something magical on browser)
-- acknowledge that the order of execution of cells matter
-- acknowledge that errors in cell execution are OK and can be recovered from
-- show how to restart with a fresh notebook
-- encourage the use of keyboard shortcuts (such as `[shift+enter]` and
-  `[ctrl+m] + key`)
+These activites have been tested in class and will be developed further.
+If you want more ideas, here are suggested activities writen by Josie Iino, a
+high school student who realized a short internship with us:
 
-**On MyBinder: avoid bad surprises by explaining to your class that the sessions
-are temporary**. Show your students how to download and upload files to
-JupyterLab so that they feel comfortable saving their work from time to time.
+- :ref:`as_gallery`
+- :ref:`as_simulator`
 
-Whatever your learning goals are, **always plan less than that**. You might
-find `this blog <https://medium.com/@jasonjwilliamsny/4-practical-suggestions-for-using-jupyter-notebooks-in-tutorials-9c478c8c0032>`_
-and this `free online book <https://jupyter4edu.github.io/jupyter-edu-book/>`_
-about teaching with jupyter notebooks useful as well.
+Using the OGGM-Edu notebooks at university
+------------------------------------------
 
-If you plan to teach about programming aspects as well as about
-glaciology, **focus on the content** more than on the method. Unfortunately
-(or fortunately), the "fun" aspect of notebooks and the programming challenges
-often distract students from what they are actually doing: glaciology and
-climatology. We've seen students googling about how to change a colormap before
-even trying to analyse the plot they just produced.
+For students with programming knowledge (or willing to learn!), the OGGM-Edu
+notebooks add a layer of depth and interactivity to the apps.
 
-If you have the chance to have more experienced students in the room,
-**organize peer-mentoring in groups of 2 or 3**. Students are often better
-in mentoring each other than we are.
+The use of notebooks in classes is expanding rapidly (see for example the
+great resource `Teaching and Learning with Jupyter <https://jupyter4edu.github.io/jupyter-edu-book/>`_
+for an in-depth introduction). At OGGM, we use notebooks frequently
+for our own `lectures <https://fabienmaussion.info/teaching/>`_ or `tutorials <https://oggm.org/tutorials>`_,
+and we are big fans! They allow to convey knowledge in an interactive and fun way,
+and they encourage active learning.
 
+Visit the `OGGM-Edu-Notebooks <https://oggm.org/oggm-edu-notebooks>`_ webpage
+to see them in action! And our :ref:`nbs_in_class` will help you to get
+started with your class.
 
-Implementation
---------------
+.. _existing-classes:
 
-Ready to give OGGM-Edu a go? You will find more information in the pages below:
+Existing classes based on OGGM-Edu
+----------------------------------
 
-.. toctree::
-    :maxdepth: 1
+Here are some known applications of OGGM-Edu in classes. You can
+use them "as is", or as templates for your own classes. We would love to hear
+back from you: if you are creating educational resources based on OGGM-Edu,
+please :ref:`get in touch <title_contact>` so that we can advertise them!
 
-    examples.rst
-    user_content.rst
-    technical_details.rst
+- `Middlebury College glaciology-labs notebooks <https://github.com/ehultee/glaciology-labs>`_,
+  adapted (and enhanced) OGGM-Edu notebooks. By `Lizz Ultee <https://ehultee.github.io/>`_.
+- `University of Michigan CLaSP 474 Ice and Climate notebooks <https://github.com/skachuck/clasp474_w2021>`_,
+  adapted (and enhanced) OGGM-Edu notebooks. By `Samuel Kachuck <http://georei.com/>`_.
+- `Three-day workshop <https://github.com/ehultee/CdeC-glaciologia>`_
+  for university students without prior glacier experience (in spanish). By `Lizz Ultee <https://ehultee.github.io/>`_.
+  More context about her class `here <https://oggm.org/2019/12/06/OGGM-Edu-AGU/>`_.

docs/index.rst

@@ -126,7 +126,9 @@ recommendations and guidelines here.
 
 * :doc:`why_oggmedu`
 * :doc:`classes_howto`
-* :doc:`examples`
+* :doc:`user_content`
+* :doc:`technical_details`
+* :doc:`other_resources`
 * :doc:`charter`
 * :doc:`roadmap`
 
@@ -137,6 +139,8 @@ recommendations and guidelines here.
 
     why_oggmedu.rst
     classes_howto.rst
+    user_content.rst
+    technical_details.rst
     other_resources.rst
     charter.rst
     roadmap.rst

docs/locale/de/LC_MESSAGES/activity_sheets/as_gallery.po

@@ -8,14 +8,42 @@ msgid ""
 msgstr ""
 "Project-Id-Version: OGGM-Edu 1.0\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2021-05-13 12:36+0200\n"
+"POT-Creation-Date: 2022-06-25 18:58+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.10.1\n"
+
+#: ../../<rst_prolog>:1
+msgid "badge_bokeh_en"
+msgstr ""
+
+#: ../../<rst_prolog>:3
+msgid "badge_bokeh_de"
+msgstr ""
+
+#: ../../<rst_prolog>
+msgid "badge_edu_notebooks"
+msgstr ""
+
+#: ../../<rst_prolog>
+msgid "badge_edu_intro_notebooks"
+msgstr ""
+
+#: ../../<rst_prolog>
+msgid "badge_tutorial_notebooks"
+msgstr ""
+
+#: ../../<rst_prolog>
+msgid "badge_hub"
+msgstr ""
+
+#: ../../<rst_prolog>
+msgid "badge_classroom_tutos"
+msgstr ""
 
 #: ../../activity_sheets/as_gallery.rst:6
 msgid "Lesson plan 1: Glacier Gallery"

docs/locale/de/LC_MESSAGES/activity_sheets/as_simulator.po

@@ -8,14 +8,42 @@ msgid ""
 msgstr ""
 "Project-Id-Version: OGGM-Edu 1.0\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2021-05-13 12:36+0200\n"
+"POT-Creation-Date: 2022-06-25 18:58+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.10.1\n"
+
+#: ../../<rst_prolog>:1
+msgid "badge_bokeh_en"
+msgstr ""
+
+#: ../../<rst_prolog>:3
+msgid "badge_bokeh_de"
+msgstr ""
+
+#: ../../<rst_prolog>
+msgid "badge_edu_notebooks"
+msgstr ""
+
+#: ../../<rst_prolog>
+msgid "badge_edu_intro_notebooks"
+msgstr ""
+
+#: ../../<rst_prolog>
+msgid "badge_tutorial_notebooks"
+msgstr ""
+
+#: ../../<rst_prolog>
+msgid "badge_hub"
+msgstr ""
+
+#: ../../<rst_prolog>
+msgid "badge_classroom_tutos"
+msgstr ""
 
 #: ../../activity_sheets/as_simulator.rst:6
 msgid "Lesson plan 3: Glacier Simulator"

docs/locale/de/LC_MESSAGES/alps_future.po

@@ -8,14 +8,42 @@ msgid ""
 msgstr ""
 "Project-Id-Version: OGGM-Edu 1.0\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2021-03-27 16:39+0100\n"
+"POT-Creation-Date: 2022-06-25 18:58+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.8.0\n"
+"Generated-By: Babel 2.10.1\n"
+
+#: ../../<rst_prolog>:1
+msgid "badge_bokeh_en"
+msgstr ""
+
+#: ../../<rst_prolog>:3
+msgid "badge_bokeh_de"
+msgstr ""
+
+#: ../../<rst_prolog>
+msgid "badge_edu_notebooks"
+msgstr ""
+
+#: ../../<rst_prolog>
+msgid "badge_edu_intro_notebooks"
+msgstr ""
+
+#: ../../<rst_prolog>
+msgid "badge_tutorial_notebooks"
+msgstr ""
+
+#: ../../<rst_prolog>
+msgid "badge_hub"
+msgstr ""
+
+#: ../../<rst_prolog>
+msgid "badge_classroom_tutos"
+msgstr ""
 
 #: ../../alps_future.rst:4
 msgid "Future evolution of glaciers in the European Alps"