The walkthrough will introduce NBfancy, a library to enrich Jupyter notebook content, and demonstrate its simple workflow to create/modify teaching material. Developing tutorials for programming often proceeds as follows: 1. Start document 2. While (not finished): a Write narrative b Write perfect example code c Run code d Copy code to document e Copy output to document 3. Write slides/handouts/exercises As we work, we notice mistakes, or find a better way of writing earlier examples. We go back, change the code and copy/paste the new input and output, which makes creating or updating training material time-consuming and undesirable. Jupyter notebooks go some way to fix this, with narrative in markdown, with basic formatting alongside code and with output in the same document. We also like the Software Carpentry (SC) teaching material, but recreating the look and practice it embraces in notebooks is not trivial. NBfancy is developed to combine the flexibility of notebooks and include SC’s pedagogy. NBfancy is a set of tools written to augment notebooks, allowing you to develop training material more effectively. We will illustrate its use with an overview of the library and some of our teaching materials.
Slides will appear
here.
