A lecture can build cleanly and still break for a reader who downloads it. Benefit: match running a lecture standalone.
The gap is the artifact, not kernel isolation — jupyter-cache already isolates kernels per notebook (single_nb_execution). Download/Colab notebooks come from sphinx-tojupyter (containers/quantecon-build/environment.yml:67) via the jupyter builder (build-lectures/action.yml:104, output :126, staged to _build/html/_notebooks :71-76), and nothing here executes them, so conversion defects ship silently. Scope is executing them (PLAN.md:117); both options first floated are dated — a venv off a base anaconda image fights the pinned-as-a-set policy (PLAN.md:96-102), and the preferred jupyter-book/MyST-NB/myst-parser engine runners were never pursued upstream.
Work items
A lecture can build cleanly and still break for a reader who downloads it. Benefit: match running a lecture standalone.
The gap is the artifact, not kernel isolation — jupyter-cache already isolates kernels per notebook (
single_nb_execution). Download/Colab notebooks come fromsphinx-tojupyter(containers/quantecon-build/environment.yml:67) via the jupyter builder (build-lectures/action.yml:104, output :126, staged to_build/html/_notebooks:71-76), and nothing here executes them, so conversion defects ship silently. Scope is executing them (PLAN.md:117); both options first floated are dated — a venv off a baseanacondaimage fights the pinned-as-a-set policy (PLAN.md:96-102), and the preferredjupyter-book/MyST-NB/myst-parserengine runners were never pursued upstream.Work items
0 0 * * 0): execute each_build/jupyter/**.ipynbin the pinned container, report per-lecture pass/failbuilders: 'html'with jupyter commented (templates/cache.yml:73-75), so requirejupyteror build thembuild-jupyter-cache's failure-issue path is inlineactions/github-script(build-jupyter-cache/action.yml:382-528), so a new job must extract or duplicate itjcache project execute --executor local-parallelpilot — a wall-clock optimisation, not an artifact check. Proposal: Optimize preview builds: phased plan for the fastest PR previews (tracking) #92 drops the lineage, this issue keeps the notebook check.