Store a single source format from which the following can be generated:
Jupyter Notebooks as they currently exist (with room for students to fill in exercise solutions) and solved notebooks
Pure python code extracted from code cells that can be tested in CI (including expected failures/exceptions)
Possibly quiz slides
Possibly markdown for the training website
There are 2 motivations for this:
Reduce the risk of mistakes in the course material.
This course should encourage and exemplify good software engineering practice. Testing is an important part of software engineering practice. Therefore this course should employ testing, even if it is invisible to students.
A possible solution could look like the PureScript Book which is checked in CI. It is distributed with NoPeeking solutions that can be tested (allowing problems and exercises to be reviewed).
MaybeJustJames
commented
2 years ago
Store a single source format from which the following can be generated:
There are 2 motivations for this:
A possible solution could look like the PureScript Book which is checked in CI. It is distributed with
NoPeekingsolutions that can be tested (allowing problems and exercises to be reviewed).