Add Rust, PyO3, and Maturin chapter (book, example, slides, instructor notes)

.gitignore

@@ -1,4 +1,5 @@
 _build
+build
 *.swp
 _output
 node_modules
@@ -8,6 +9,12 @@ node_modules
 CLAUDE.md
 .claude/
 
+# Agent-local tool state
+.serena/
+
 # pixi environments
 .pixi/*
 !.pixi/config.toml
+
+# Python virtual environments
+.venv/

.pre-commit-config.yaml

@@ -42,7 +42,7 @@ repos:
     rev: "06507ab9500d4a9919b5ebd76d9d5b7074f15c1f" # frozen: v3.8.4
     hooks:
       - id: prettier
-        exclude: '\.md$' # Markdown is handled by rumdl
+        exclude: '(\.md$|(^|/)pixi\.lock$)' # Markdown is handled by rumdl; pixi.lock is generated by pixi (see .gitattributes)
 
   - repo: https://github.com/codespell-project/codespell
     rev: "2ccb47ff45ad361a21071a7eedda4c37e6ae8c5a" # frozen: v2.4.2

AGENTS.md

@@ -2,7 +2,7 @@
 
 ## What this is
 
-SIMPLE-Py is a workshop that teaches simple compiled Python packaging (C++, Rust, publishing). It is **content, not code**: a [MyST](https://mystmd.org/) book plus [Marp](https://marp.app/) slides, deployed to GitHub Pages. There is no Python package to build or test here — edits are to Markdown.
+SIMPLE-Py is a workshop that teaches simple compiled Python packaging (C++, Rust, publishing). It is **content, not code**: a [MyST](https://mystmd.org/) book plus [Marp](https://marp.app/) slides, deployed to GitHub Pages. The book itself has no package to build or test (edits are to Markdown), though some chapters have runnable companion projects under `examples/`.
 
 ## Commands
 
@@ -19,11 +19,13 @@ prek -a --quiet       # lint/format everything (ruff-format, blacken-docs, rumdl
 
 ## Structure
 
-- **`content/`** — book chapters as Markdown, grouped by section directory (`basic-packaging/`, `compiled/`, `scikit-build/`, `other-tools/`, `interesting/`). Files are prefixed with an order number (`01_`, `02_`, …). Images live alongside their chapter, prefixed with the chapter stem (e.g. `04_distros-shipping.jpg`).
-- **`myst.yml`** — book config and the **table of contents**. Adding or reordering a chapter file requires editing the `toc` here; the filesystem order is not authoritative.
-- **`slides/`** — Marp decks (`marp: true` frontmatter, `theme: simplepy` → `slides/simplepy.css`). Named `<section>_<chapter>_<name>.md` where the leading digit ties the deck to its content section.
+- **`content/`** - book chapters as Markdown, grouped by section directory (`basic-packaging/`, `compiled/`, `scikit-build/`, `other-tools/`, `interesting/`). Files are prefixed with an order number (`01_`, `02_`, …). Images live alongside their chapter, prefixed with the chapter stem (e.g. `04_distros-shipping.jpg`).
+- **`myst.yml`** - book config and the **table of contents**. Adding or reordering a chapter file requires editing the `toc` here; the filesystem order is not authoritative.
+- **`slides/`** - Marp decks (`marp: true` frontmatter, `theme: simplepy` → `slides/simplepy.css`). Named `<section>_<chapter>_<name>.md` where the leading digit ties the deck to its content section.
+- **`examples/`** - runnable companion projects for chapters, named `<section>_<chapter>_<name>` like the slides (e.g. `2_04_rust_pyo3/` is a pixi-managed PyO3 extension). Each is self-contained: `pixi install`, then tasks like `pixi run test` or `pixi run bench` from inside the example directory.
+- **`instructor-notes/`** - instructor-facing research notes and deep dives, with Obsidian-style frontmatter and `[[wiki-links]]`. Deliberately absent from the `myst.yml` toc, so they are never published into the book.
 
 ## Conventions
 
-- `blacken-docs` formats Python code blocks inside Markdown, and `ruff-format` runs on code — keep embedded code snippets valid and formatted.
+- `blacken-docs` formats Python code blocks inside Markdown, and `ruff-format` runs on code - keep embedded code snippets valid and formatted.
 - CI (`.github/workflows/cd.yml`) builds with `BASE_URL: /SIMPLE-Py` and deploys to Pages on push to `main`.