RSEConUK 2019 has ended
The Fourth Conference of Research Software Engineering was held at the University of Birmingham.

Content from all sessions is licensed under a Creative Commons Attribution 2.0 UK: England & Wales License.
Back To Schedule
Wednesday, September 18 • 13:30 - 13:55
#4B1 - Training, Teaching and Code Review - Nbfancy: Generating and delivering better training material

Log in to save this to your schedule, view media, leave feedback and see who's attending!

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.

avatar for Jack Betteridge

Jack Betteridge

University of Bath
avatar for James Grant

James Grant

Research Software Engineer, University of Bath

Wednesday September 18, 2019 13:30 - 13:55 BST
1. Bramall - Elgar Concert Hall Aston Webb Building