Summary
Convert all tutorial notebooks in examples/tutorials/ to jupytext paired format (.py percent + .ipynb) and integrate notebook generation/execution into the release and documentation workflow.
Context
We converted try_optuna.ipynb → hyperparameter_tuning_with_optuna.{py,ipynb} using jupytext pairing as part of the tuning refactor. The .py source is much easier to edit, review, and diff. The remaining notebooks should follow the same pattern.
Notebooks to convert
Workflow integration
Notes
- Jupytext is already in dev dependencies
- Per-file Ruff ignores and Pyright exclusions for
examples/tutorials/ are already configured
- Each
.py file should have the SPDX header after (not before) the jupytext YAML frontmatter
Summary
Convert all tutorial notebooks in
examples/tutorials/to jupytext paired format (.pypercent +.ipynb) and integrate notebook generation/execution into the release and documentation workflow.Context
We converted
try_optuna.ipynb→hyperparameter_tuning_with_optuna.{py,ipynb}using jupytext pairing as part of the tuning refactor. The.pysource is much easier to edit, review, and diff. The remaining notebooks should follow the same pattern.Notebooks to convert
forecasting_with_workflow_presets.ipynbbacktesting_openstef_with_beam.ipynbWorkflow integration
poe notebooks) that runsjupytext --syncon all paired notebooksjupyter executeorpapermill) to verify they run without errors.pyand.ipynbstay in syncNotes
examples/tutorials/are already configured.pyfile should have the SPDX header after (not before) the jupytext YAML frontmatter