From 41b8e9d8c37738a94c5d4a9e1a1bec2d446bbe08 Mon Sep 17 00:00:00 2001
From: Christoph Fink <christoph.fink@gmail.com>
Date: Tue, 21 Feb 2023 14:05:51 +0200
Subject: [PATCH 1/3] add better instructions for future teachers to readme

---
 README.md | 33 +++++++++++++++++++--------------
 1 file changed, 19 insertions(+), 14 deletions(-)

diff --git a/README.md b/README.md
index a450d471d..4469dfd8f 100644
--- a/README.md
+++ b/README.md
@@ -108,15 +108,27 @@ few days to get everything set up.
    [Follow the instructions in the `Automating-GIS-processes/csc-notebook-dockerfile`
    repository](https://github.com/Automating-GIS-processes/csc-notebook-dockerfile)
 
-4. Set up Slack TODO
-
-5. Set up GitHub classroom TODO (make new org, create per-exercise repository)
+4. Set up Slack: Create a new Slack instance, e.g.,
+   ‘Automating-GIS-processes-2023’, and set up the channel structure such as in
+   previous years: `#general` and `#random` exist by default, create `#week1`
+   through `#week7`, as well as `#final-assignments`; create `#instructors` to
+   coordinate with the student tutors. *I (@christophfink) will leave the 2022
+   version around, drop me a line and I’ll add you there so you can see for what
+   we used Slack*.
+
+5. Set up GitHub classroom: register for GitHub Education
+   (https://classroom.github.com), create a new organisation for this year’s
+   exercise repository templates (see
+   [Automating-GIS-processes-2022](https://github.com/Automating-GIS-processes-2022),
+   and add the exercise repositories there, one by one, as the course advances.
+   For each exercise, create a classroom, and update the links in the respective
+   `docs/lesson-X/exercise-X.md` files.
 
 6. Update the course details defined in [`conf.py`](docs/conf.py). Things that
-change every year are set up as ‘substitutions’, variables that are replaced
-throughout all documents. Edit them to reflect this year’s course’s details
-(as of October 2022, this block is starting [at line 42 of
-`conf.py`](docs/conf.py#L42)):
+   change every year are set up as ‘substitutions’, variables that are replaced
+   throughout all documents. Edit them to reflect this year’s course’s details
+   (as of October 2022, this block is starting [at line 42 of
+   `conf.py`](docs/conf.py#L42)):
 
     ```
     # The following are the main things that need to be updated every year
@@ -133,13 +145,6 @@ throughout all documents. Edit them to reflect this year’s course’s details
 
 <!--
 TODO: Add instructions for future teachers of this course:
-    - How to set up GitHub class rooms
-    - How to update the documents (including setting the
-      substitution-variable in conf.py)
-    - How to set up Slack, and where to change the links
-    - How to update the dependencies at the beginning of a new year,
-      and how to lock them to certain versions
-    - How to locally install the dependencies using a virtual env, or conda env
     - How to regenerate the docs locally
     - How to fork the repository, and use merge requests as a way to test
       changes before going live

From 1bd11f65c0a61ddd557cefbcfc1ef4219c850eae Mon Sep 17 00:00:00 2001
From: Christoph Fink <christoph.fink@gmail.com>
Date: Tue, 21 Feb 2023 14:07:32 +0200
Subject: [PATCH 2/3] formatting

---
 README.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 4469dfd8f..1f9af83ee 100644
--- a/README.md
+++ b/README.md
@@ -103,12 +103,12 @@ few days to get everything set up.
       you want to stick with the previous version, as some of the packages
       might not have been updated in time.
 
-3. Update the docker image for the *CSC Notebooks*, and upload it to CSC’s registry.
+3. **Update the docker image** for the *CSC Notebooks*, and upload it to CSC’s registry.
    Create a *CSC Notebooks* ‘workspace’ and ‘application’ using the docker image.
    [Follow the instructions in the `Automating-GIS-processes/csc-notebook-dockerfile`
    repository](https://github.com/Automating-GIS-processes/csc-notebook-dockerfile)
 
-4. Set up Slack: Create a new Slack instance, e.g.,
+4. **Set up Slack**: Create a new Slack instance, e.g.,
    ‘Automating-GIS-processes-2023’, and set up the channel structure such as in
    previous years: `#general` and `#random` exist by default, create `#week1`
    through `#week7`, as well as `#final-assignments`; create `#instructors` to
@@ -116,7 +116,7 @@ few days to get everything set up.
    version around, drop me a line and I’ll add you there so you can see for what
    we used Slack*.
 
-5. Set up GitHub classroom: register for GitHub Education
+5. **Set up GitHub classroom**: register for GitHub Education
    (https://classroom.github.com), create a new organisation for this year’s
    exercise repository templates (see
    [Automating-GIS-processes-2022](https://github.com/Automating-GIS-processes-2022),
@@ -124,7 +124,7 @@ few days to get everything set up.
    For each exercise, create a classroom, and update the links in the respective
    `docs/lesson-X/exercise-X.md` files.
 
-6. Update the course details defined in [`conf.py`](docs/conf.py). Things that
+6. **Update the course details** defined in [`conf.py`](docs/conf.py). Things that
    change every year are set up as ‘substitutions’, variables that are replaced
    throughout all documents. Edit them to reflect this year’s course’s details
    (as of October 2022, this block is starting [at line 42 of

From 36b5456fd1da888b93cc4c58aaac143e1bb1e5be Mon Sep 17 00:00:00 2001
From: Christoph Fink <christoph.fink@gmail.com>
Date: Wed, 9 Aug 2023 14:32:23 +0300
Subject: [PATCH 3/3] first steps for 2023

---
 docs/conf.py  |   6 +-
 docs/index.md | 164 +++++++++++++++++++++++++-------------------------
 2 files changed, 85 insertions(+), 85 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index 12c65b463..7ebdb508f 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -7,8 +7,8 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
 project = "Automating GIS Processes"
-version = "2022"
-release = "2022"
+version = "2023"
+release = "2023"
 
 author = "Henrikki Tenkanen, Vuokko Heikinheimo, Håvard Wallin Aagesen, Christoph Fink"
 copyright = f"2016-{version}"
@@ -45,7 +45,7 @@
 # These variables are replaced throughout the course documents
 # (see the comment for the first item for an example)
 myst_substitutions = {
-    "year": "2022",  # use {{year}} in markdown files to replace it with the current value
+    "year": "2023",  # use {{year}} in markdown files to replace it with the current value
     "starting_date": "Tuesday, 1 November 2022",
     "lectures_weekday_time_location": "Tuesday, 15:15-16:45, Exactum C222",
     "work_sessions_weekday_time_location": "Friday, 12:15-16:00, Physicum A113+A114 (GIS lab)",
diff --git a/docs/index.md b/docs/index.md
index e03226012..5ae5dbd18 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -138,88 +138,88 @@ course-info/resources
 course-info/license
 ```
 
-```{toctree}
----
-caption: Lesson 1
-maxdepth: 2
----
-lessons/lesson-1/overview
-lessons/lesson-1/course-motivation
-lessons/lesson-1/geometry-objects
-lessons/lesson-1/exercise-1
-```
-
-```{toctree}
----
-caption: Lesson 2
-maxdepth: 2
----
-lessons/lesson-2/overview
-lessons/lesson-2/key-concepts
-lessons/lesson-2/managing-file-paths
-lessons/lesson-2/vector-data-io
-lessons/lesson-2/geopandas-an-introduction
-lessons/lesson-2/map-projections
-lessons/lesson-2/exercise-2
-```
-
-```{toctree}
----
-caption: Lesson 3
-maxdepth: 2
----
-lessons/lesson-3/overview
-lessons/lesson-3/geocoding
-lessons/lesson-3/geocoding-in-geopandas
-lessons/lesson-3/point-in-polygon-queries
-lessons/lesson-3/intersect
-lessons/lesson-3/spatial-join
-lessons/lesson-3/exercise-3
-```
-
-```{toctree}
----
-caption: Lesson 4
-maxdepth: 2
----
-lessons/lesson-4/overview
-lessons/lesson-4/overlay-analysis
-lessons/lesson-4/vector-data-aggregating
-lessons/lesson-4/simplifying-geometries
-lessons/lesson-4/reclassifying-data
-lessons/lesson-4/exercise-4
-```
-
-```{toctree}
----
-caption: Lesson 5
-maxdepth: 2
----
-lessons/lesson-5/overview
-lessons/lesson-5/static-maps
-lessons/lesson-5/interactive-maps
-lessons/lesson-5/exercise-5
-```
-
-```{toctree}
----
-caption: Lesson 6
-maxdepth: 2
----
-lessons/lesson-6/overview
-lessons/lesson-6/retrieve-data-from-openstreetmap
-lessons/lesson-6/network-analysis
-```
-
-```{toctree}
----
-caption: Final Assignment
-maxdepth: 2
----
-final-assignment/final-assignment
-final-assignment/final-assignment-grading
-final-assignment/final-assignment-hints
-```
+%```{toctree}
+%---
+%caption: Lesson 1
+%maxdepth: 2
+%---
+%lessons/lesson-1/overview
+%lessons/lesson-1/course-motivation
+%lessons/lesson-1/geometry-objects
+%lessons/lesson-1/exercise-1
+%```
+
+%```{toctree}
+%---
+%caption: Lesson 2
+%maxdepth: 2
+%---
+%lessons/lesson-2/overview
+%lessons/lesson-2/key-concepts
+%lessons/lesson-2/managing-file-paths
+%lessons/lesson-2/vector-data-io
+%lessons/lesson-2/geopandas-an-introduction
+%lessons/lesson-2/map-projections
+%lessons/lesson-2/exercise-2
+%```
+
+%```{toctree}
+%---
+%caption: Lesson 3
+%maxdepth: 2
+%---
+%lessons/lesson-3/overview
+%lessons/lesson-3/geocoding
+%lessons/lesson-3/geocoding-in-geopandas
+%lessons/lesson-3/point-in-polygon-queries
+%lessons/lesson-3/intersect
+%lessons/lesson-3/spatial-join
+%lessons/lesson-3/exercise-3
+%```
+
+%```{toctree}
+%---
+%caption: Lesson 4
+%maxdepth: 2
+%---
+%lessons/lesson-4/overview
+%lessons/lesson-4/overlay-analysis
+%lessons/lesson-4/vector-data-aggregating
+%lessons/lesson-4/simplifying-geometries
+%lessons/lesson-4/reclassifying-data
+%lessons/lesson-4/exercise-4
+%```
+
+%```{toctree}
+%---
+%caption: Lesson 5
+%maxdepth: 2
+%---
+%lessons/lesson-5/overview
+%lessons/lesson-5/static-maps
+%lessons/lesson-5/interactive-maps
+%lessons/lesson-5/exercise-5
+%```
+
+%```{toctree}
+%---
+%caption: Lesson 6
+%maxdepth: 2
+%---
+%lessons/lesson-6/overview
+%lessons/lesson-6/retrieve-data-from-openstreetmap
+%lessons/lesson-6/network-analysis
+%```
+
+%```{toctree}
+%---
+%caption: Final Assignment
+%maxdepth: 2
+%---
+%final-assignment/final-assignment
+%final-assignment/final-assignment-grading
+%final-assignment/final-assignment-hints
+%```
 
 % ```{toctree}
 % ---