page about "homework" closes #44, closes #46

Author: bast

content/index.md

@@ -16,6 +16,7 @@ Image to get started:
 questions
 learning-outcomes
 lesson
+optional-homework
 encapsulation
 :::
 

content/lesson.md

@@ -70,9 +70,3 @@ the ideas and steps in the {ref}`guide`.
 It is OK and good if mistakes happen and it is fun if the instructor(s) can
 convey a bit of "improv" feel to this lesson.
 :::
-
-
-## Additional exercises
-
-Draw a call tree for one of your recent projects. Identify the
-functions in your call tree which are "pure" (which have no side-effects).

content/optional-homework.md

@@ -0,0 +1,36 @@
+# Optional home-/group work
+
+:::{admonition} This is completely optional
+You can participate in the lesson without working on any of the tasks below.
+
+We share these for individuals and groups who would like to work on some of
+these in preparation of the lesson or independently of a CodeRefinery workshop
+with their study group.
+
+We might comment on the contributed solutions during the lesson
+but we will definitely do so in a constructive and positive way.
+:::
+
+You can practice on our [exercise repository](https://github.com/coderefinery/modular-type-along-exercise) which contains:
+- Data set
+- Python notebook which works but is not super general
+
+How to contribute improvements:
+- Open issue at the [exercise repository](https://github.com/coderefinery/modular-type-along-exercise) and in your pull request refer to that issue.
+
+Exercise ideas (sorted from basic to advanced):
+- Improve the README
+- Add example usage to the README
+- Add a result image to the README
+- Make it installable and document installation (requirements.txt or environment.yml, pip/conda/...)
+- Add a command line interface
+- Improve error messages (e.g. input file does not exist or does not contain data we want to plot)
+- Draw a call tree for one of your recent projects. Identify the
+  functions in your call tree which are "pure" (which have no side-effects).
+- Add more automated tests
+- Try some of the strategies in this lesson on your own data
+- Contribute a notebook/script with weather data from your place **in your
+  favorite programming language**
+- If you use AI, any tricks you can share to get modular code from it?
+- Make the notebook (more) reproducible
+- Add support for Snakemake or any other workflow management tool