Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -176,9 +176,10 @@ Thank you! Please report it at https://github.com/MarinhoLab/OpenExecutableBooks
- Example: `fix/typos-and-uk-english`, `feat/add-lesson6`

### Files excluded from version control:
- `venv/` — Python virtual environment
- `_build/` — Build artifacts
- `basic_lessons/*.ipynb` — Generated at build time from `.md` files
- `basic_lessons/*.ipynb` — Generated at build time from `.md` files (via `basic_lessons/.gitignore`)

There is intentionally no root `.gitignore`. If you create local `venv/` or `_build/`
directories, keep them out of commits (e.g. via `.git/info/exclude`).

---

Expand Down
13 changes: 9 additions & 4 deletions TODO.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,14 +11,19 @@ that properly shows the video but not the image.

## Text-based notebooks

- Converting from traditional Jupyter notebooks to text-based notebooks might be an interesting topic to explore. See
**Done — achieved in August 2026.** The lessons were migrated from classic Jupyter
notebooks to MyST text-based notebooks (`.md` with `{code-cell}` directives), stored
under `basic_lessons/` (see [PR #9](https://github.com/MarinhoLab/OpenExecutableBooksRobotics/pull/9)).
The items below are therefore no longer open:

- ~~Converting from traditional Jupyter notebooks to text-based notebooks might be an interesting topic to explore. See
[link](https://myst-nb.readthedocs.io/en/latest/authoring/text-notebooks.html#authoring-text-notebooks). Classic notebooks
store cell output on themselves, with implications on version control software. While classic Jupyter notebooks are more
easily usable without extensions, `jupytext` seemingly allows for the conversions. See [link](https://jupyterbook.org/en/stable/file-types/myst-notebooks.html).
- The so-called [paired notebooks](https://jupytext.readthedocs.io/en/latest/paired-notebooks.html) are possibly the solution.
easily usable without extensions, `jupytext` seemingly allows for the conversions. See [link](https://jupyterbook.org/en/stable/file-types/myst-notebooks.html).~~
- ~~The so-called [paired notebooks](https://jupytext.readthedocs.io/en/latest/paired-notebooks.html) are possibly the solution.
Given that the latex macros sometimes do not render well in `jupyterlab`, this could become indirectly a solution.
The latex support for `myst` is much less hacky, so it is likely that the notebooks exported from the text version
are more likely to be compatible with `jupyterlab`.
are more likely to be compatible with `jupyterlab`.~~

## Notes

Expand Down
6 changes: 6 additions & 0 deletions basic_lessons/lesson1_exercise_answers.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,12 @@ kernelspec:
## I found an issue
Thank you! Please report it at https://github.com/MarinhoLab/OpenExecutableBooksRobotics/issues

# Package installation

````{code-cell}
%%capture
%pip install numpy
````

# Valid imports

Expand Down
6 changes: 6 additions & 0 deletions basic_lessons/lesson2_exercise_answers.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,12 @@ kernelspec:
## I found an issue
Thank you! Please report it at https://github.com/MarinhoLab/OpenExecutableBooksRobotics/issues

# Package installation

````{code-cell}
%%capture
%pip install numpy
````

# Valid imports

Expand Down
6 changes: 6 additions & 0 deletions basic_lessons/lesson3_exercise_answers.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,12 @@ kernelspec:
## I found an issue
Thank you! Please report it at https://github.com/MarinhoLab/OpenExecutableBooksRobotics/issues

# Package installation

````{code-cell}
%%capture
%pip install numpy
````

# Valid imports

Expand Down
6 changes: 6 additions & 0 deletions basic_lessons/lesson4_exercise_answers.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,12 @@ kernelspec:
## I found an issue
Thank you! Please report it at https://github.com/MarinhoLab/OpenExecutableBooksRobotics/issues

# Package installation

````{code-cell}
%%capture
%pip install numpy
````

# Valid imports

Expand Down
Loading