Authoring Notebooks: Start to Finish

Here are a series of recordings that lead through how to author Jupyter Notebooks as well as Otter-Graded based notebooks.

Part 1: Setting up your environment Screen Recording (5 min)

The first step in authoring is configure the repositories and editing environment you need. In this recording we illustrate:

• the creation of the GitHub Repositories needed for students and instructor materials

• Uploading notebook and accompanying materials to a JupyterHub in order to facilitate making changes

Part 2: Running Otter Assign Screen Recording (12 min)

This part reviews Part 1, assumes the changes you need to make and now we run otter assign. The video illustrates, from a JupyterHub, the otter assign workflow once you have a otterized-notebook ready to be published. After the otter assign moment, we copy the student materials and instructor materials into the repositories created in Part 1.

Part 3: Distributing Notebook to Students(nbgitpuller links) Screen Recording (5 min)

If you are going to change the name of a notebook or you have a notebook you created from scratch, you can create special links that allow students to open notebooks seamlessly on a JupyterHub. This recording shows how these links are created via the nbgitpuller Chrome Extension.

Part 4: Authoring Jupyter Notebooks(without otter-grader!) Screen Recording (12 min)

If you are ambitious and branching out to create your own course or creating new assignments and content in an existing course, you may need to create a Jupyter Notebook that does not include self-grading -- a good example is a Jupyter Notebook used in a lecture that students may follow along with. There is no need for self-checks or instructor grading of these notebooks.

This recording also reviews uploading your notebooks(Part 2) and associated files to GitHub as well as generating the nbgitpuller link for distribution(Part 3).

Part 5: Authoring Jupyter Notebooks with Otter-Graded Content Screen Recording (13 min)

This adds onto Part 4, by including examples of Markdown to create otter-graded self-check questions as well as instructor grading questions. This includes assigning points as well as exploring how we might create questions that require students to code, answer short-answer or free-form questions or respond Multiple Choice prompts. The example notebook used in this video can be viewed on this page.