This repository contains an evolving collection of exemplar notebooks, guidance materials and reusable teaching resources for Noteable®.
It supports staff and students using Noteable® for teaching, learning, assessment and exploratory programming. The repository includes subject- and workflow-based notebook examples, reusable templates, and guidance on Noteable® features and service updates.
The initial collection was developed during Summer 2026. It will be expanded and maintained as new examples, disciplines, workflows and teaching requirements are identified.
| Folder | Description |
|---|---|
assets/ |
Shared images, datasets, videos and other supporting files used by guidance and exemplar notebooks. |
exemplars/ |
Subject-, workflow- and use-case-based exemplar notebooks. |
guidance/ |
Guidance documents and supporting material for using Noteable® and its features. |
templates/ |
Reusable notebook and documentation templates for developing new materials. |
The guidance/ folder includes guidance supporting the Summer 2026 Noteable® update and Academic Year 2026–27, including:
- Noteable® Assignment Workflow Updates — Guidance for AY 2026–27
- Noteable® Summer 2026 Environment and User Interface Updates
- Using Coding Agents in Noteable® with ELM® API Keys — University of Edinburgh guidance
- Coding Agents in Noteable® — Guidance for AY 2026–27
Coding-agent guidance is provided in two versions:
- a general version for Noteable® users and institutions; and
- a University of Edinburgh-specific version covering the use of ELM® API keys with compatible coding-agent workflows.
Before using an exemplar notebook:
- Read the notebook description and confirm that it is suitable for your intended teaching or learning activity.
- Select the required Noteable® environment or kernel.
- Review any setup instructions, required data files, packages, extensions or other dependencies.
- Test the notebook in your own Noteable® workspace before using it in teaching or assessment.
- Adapt the material, where appropriate, for your course, learning outcomes and local guidance.
Some notebooks may rely on datasets, libraries, extensions or command-line tools that are only available in particular Noteable® environments.
For information about current notebook environments, key libraries and installed tools, see the Noteable® Notebook Descriptions page.
New materials should be easy to find, understand, reuse and maintain.
Each exemplar should include, either at the beginning of the notebook or in an accompanying README file:
- a clear title and short description of its purpose;
- intended audience, discipline or teaching context;
- learning outcomes or expected use case, where relevant;
- required Noteable® environment and kernel;
- required data, packages, extensions and other dependencies;
- setup and running instructions;
- the date created and date last reviewed;
- a named maintainer or owner, where possible; and
- relevant licensing, attribution and data-use information.
Please do not include personal, confidential, sensitive or restricted data in notebooks, supporting files or generated outputs.
This repository is not a fixed archive of Summer 2026 work. It is intended to be a maintained and expanding resource for Noteable® teaching examples and guidance.
When adding or revising materials:
- use clear and descriptive filenames;
- place files in the most appropriate folder;
- store reusable supporting files in
assets/; - test notebooks in the stated Noteable® environment;
- update associated documentation when changing a workflow or dependency;
- do not include API keys, passwords, access tokens or other secrets; and
- ensure examples are appropriate for their intended teaching and assessment context.
For further information and support:
This repository is licensed under the Creative Commons Zero v1.0 Universal licence (CC0 1.0).