# Reproducible notebooks: Jupyter, R and execution environments

Decision workbook and teaching example · 2026-10-06

The completed case is fictional. Its values and decisions are not actual findings; complete your project using relevant permissions, methods and requirements.

- Project: ____________________
- Researcher and role: ____________________
- Date and version: ____________________
- Data seen before the decision: ____________________
- Aim and scope: ____________________

## Completed example

| Stage/decision | Example | Check or action |
| --- | --- | --- |
| Clean start | Fresh kernel and cleared outputs | Any hidden state? |
| Order | Run all cells from the top | Independent of prior clicks? |
| Environment | Library and data versions | Are setup commands explicit? |
| Randomness | Seed and system limits | Are determinism claims justified? |
| Delivery | Fresh output and execution log | Do document numbers agree? |

## Complete your own record

| Topic | Actual decision and reason | Evidence link and status |
| --- | --- | --- |
| Clean start | __________ | __________ |
| Order | __________ | __________ |
| Environment | __________ | __________ |
| Randomness | __________ | __________ |
| Delivery | __________ | __________ |

## Completion checks

- [ ] Keep the clean-run notebook, environment and execution log.

## Changes and limitations

| Date | Change | Data known at decision time | Reason | Consequence for claim | Reviewer |
| --- | --- | --- | --- | --- | --- |
| __________ | __________ | __________ | __________ | __________ | __________ |

## Sources and further reading

- [JupyterLab — Notebooks](https://jupyterlab.readthedocs.io/en/stable/user/notebook.html)
- [Cornell Data Services — Writing READMEs for Research Data](https://data.research.cornell.edu/data-management/sharing/readme/)
- [Python documentation](https://docs.python.org/3/)
- [The R Project](https://www.r-project.org/)

Related guide: https://didgar-research-site1.vercel.app/en/guides/reproducible-notebooks/