Consider updating to Jupyterbook 2 / MystMD

Open

#362 opened on Jul 10, 2026 2 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty: 4/5
Estimated time: 3-5 days
Newbie friendliness: 48/100

Issue type: Refactor
Clarity: Mostly clear
Activity status: Quiet
Tech stack: jupyter-notebook
Domain: build-system, documentation

Research direction

Start with the JupyterBook 1 maintenance FAQ and the pinned dependency at pyproject.toml line 74. Scope the migration to JupyterBook >=2, including the stated removal of Sphinx and adoption of MyST. Done means the repository’s tutorial build works with the new toolchain.

Written by the indexing model from the issue text.

Description

help wanted

This repository currently pins jupyterbook<2 which is now in maintenance mode and will probably become increasingly harder to update
https://github.com/xarray-contrib/xarray-tutorial/blob/2ac823ee3f29db4e95726df3c568d8e11bb46396/pyproject.toml#L74

https://jupyterbook.org/stable/resources/faq/#will-jupyter-book-1-continue-to-be-maintained

But updating to JupyterBook>=2 would take some time, drop sphinx, and start using myst...

Dominant language: Jupyter Notebook
Stars: 204
Forks: 121
PR merge metrics: No merged PRs in 30d

Contributor guide

Open the contributing guide

First steps

Read the whole issue, then the project's contributing guide.
Comment on the issue to say you are picking it up — it saves two people doing the same work.
Fork the repository and make your change on a branch.
Open a pull request that references the issue number.

Similar issues

verify-gofmt cannot fail: it runs gofmt -w before the check Open

kind/bug

Difficulty 2/5 1-3 hours Newbie friendliness 88/100

kubernetes-sigs/prow#953 · 1 comment · Opened Sep 21, 2026
Build fails with LTO enabled: conflicting types for z_shared_sw_isr_table between isr_tables.c and sw_isr_table.h Open

Difficulty 2/5 1-3 hours Newbie friendliness 88/100

zephyrproject-rtos/zephyr#119726 · Opened Sep 21, 2026
lenovolegionlinux: new version 0.0.31 Open

out-of-date

Difficulty 1/5 Under an hour Newbie friendliness 82/100

CachyOS/CachyOS-PKGBUILDS#1894 · Opened Sep 21, 2026
web: `npm run build -w web` always fails — `vite.config.ts` does not typecheck (TS18048) Open

comp/dashboard P3 type/bug

Difficulty 2/5 1-3 hours Newbie friendliness 86/100

NousResearch/hermes-agent#117722 · Opened Sep 21, 2026
`Assembler` still logs a cache-skipped file as freshly assembled, the same defect #1669 fixed in `Disassembler` Open

bug

Difficulty 1/5 Under an hour Newbie friendliness 92/100

objectionary/jeo-maven-plugin#1760 · Opened Sep 20, 2026

More Build System issues