Attending this event?
Welcome to the Fourth Conference of Research Software Engineering, held at the University of Birmingham. For directions to and during the event, see the campus maps page.

In the Aston Webb Building near to the registration/reception desk, a cloakroom is available in room G30 along with a quiet room in G31.
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 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.

avatar for James Grant

James Grant

Research Software Engineer, University of Bath

Wednesday September 18, 2019 13:30 - 13:55
2. Aston Webb C Block Lecture Theatre Aston Webb Building