Skip to content

Migrate from .ipynb to MyST text notebooks (.md) - #9

Merged
mmmarinho merged 2 commits into
mainfrom
feat/migrate-to-myst-text-notebooks
Aug 17, 2026
Merged

Migrate from .ipynb to MyST text notebooks (.md)#9
mmmarinho merged 2 commits into
mainfrom
feat/migrate-to-myst-text-notebooks

Conversation

@mmmarinho

Copy link
Copy Markdown
Contributor

This PR replaces the Jupyter notebook (.ipynb) format with MyST text notebooks (.md) as the canonical lesson format.

What changed:

  • basic_lessons/ — Replaced all .ipynb files with .md MyST text notebooks from unstable/
  • New lessonlesson0_tutorial.md (virtual environment setup) added as lesson 0
  • Removedunstable/ directory (lessons promoted to stable), convert_to_myst.py (no longer needed)
  • myst.yml — TOC now points to .md files, lesson0 added, unstable section removed
  • basic_lessons/README.md — Updated to reflect MyST format and added lesson0
  • .github/workflows/notebook_to_html.yml — Added PR trigger, renamed workflow to "MyST Book"
  • AGENTS.md — Updated documentation to reflect new MyST text notebook structure

Benefits:

  • Version-control friendly (plain text diff instead of JSON blobs)
  • Human-readable lesson files
  • No conversion step needed between formats

This PR was created by an AI agent (OpenHands) on behalf of the maintainer.

- Replace basic_lessons/*.ipynb with MyST text notebooks (.md) from unstable/
- Add new lesson0_tutorial (virtual environment setup) to basic_lessons
- Remove unstable/ directory (lessons promoted to stable)
- Remove convert_to_myst.py (no longer needed)
- Update myst.yml: point TOC to .md files, add lesson0, remove unstable section
- Update basic_lessons/README.md: reflect new format and add lesson0
- Update GitHub Actions workflow: add PR trigger, rename to 'MyST Book'
- Update AGENTS.md: reflect new MyST text notebook structure
@review-notebook-app

Copy link
Copy Markdown

Check out this pull request on  ReviewNB

See visual diffs & provide feedback on Jupyter Notebooks.


Powered by ReviewNB

@mmmarinho mmmarinho left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍

@mmmarinho
mmmarinho marked this pull request as ready for review August 17, 2026 21:15
@mmmarinho
mmmarinho merged commit 0a03af3 into main Aug 17, 2026
4 checks passed
@mmmarinho
mmmarinho deleted the feat/migrate-to-myst-text-notebooks branch August 17, 2026 21:15
mmmarinho pushed a commit that referenced this pull request Aug 17, 2026
…GENTS.md

- Add the missing "Package installation" section (%%capture %pip install
  numpy) to L1, L2, L3 and L4 exercise answers, matching the L5 and
  tutorial lessons
- TODO.md: mark the text-based notebooks section as achieved in August
  2026 (classic .ipynb notebooks migrated to MyST text notebooks in
  PR #9) and cross out the completed items
- AGENTS.md: fix the "files excluded from version control" section,
  which claimed venv/ and _build/ were git-ignored although no root
  .gitignore exists

Co-authored-by: openhands <openhands@all-hands.dev>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants