10 Commits
Author SHA1 Message Date
Vijay Janapa Reddi 40a27a1d50 vol1: rename ch03 ml_workflow to ml_lifecycle
Retitle the chapter ML Lifecycle and rename its folder, files, assets,
lab, slides, audit data, and instructor links, with redirects for the
old URLs. Section IDs keep the sec-ml-workflow prefix. Update the ch2
hand-off and the conclusion to name the lifecycle.
2026-10-10 19:40:22 +02:00
Vijay Janapa Reddi 811d8f227a vol1: rename ch02 ml_systems to system_paradigms; revise intro, notation, about
Rename the chapter folder, assets, lab, slides, audit data, and staffml
links from 02_ml_systems to 02_system_paradigms, with redirects for the
old URLs. Revise the introduction, notation, conventions, and about
pages, adding the frontmatter stack figures. Add park2024offloading.
2026-10-09 23:11:44 +02:00
Vijay Janapa Reddi 43842f87d1 Merge remote-tracking branch 'origin/dev' into dev 2026-09-15 14:39:12 +02:00
Mehdi BoutayebandClaude Opus 4.8 6c0e02bebb Fix invalid escape sequences in book tooling scripts
binder/tools/scripts/testing/tikz_style_linter.py (`\}`) and
binder/tools/scripts/content/fix_capitalization.py (`\i`) use invalid
escape sequences in non-raw string literals. Python 3.12+ raises
SyntaxWarning: invalid escape sequence, and the tooling runs on the
3.10-3.13 CI matrix. Escaping the backslashes preserves each value.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014HBQNzAf5C2E3MiJC48HQw
2026-09-15 09:49:12 +02:00
Vijay Janapa Reddi ec8e79243f cleanup(binder): remove finished one-off codemods
Each script was run against the current tree first. migrate_lego_m_as, fix_l015_prose_dup_units, and fix_glued_cell_fences find nothing left to change. fix_alt_text needs an edits file that is no longer in the repository, convert_icons converts icons that no longer exist, and fix_prose_spurious only forwarded to fmt/fix_spurious_prose.py. fix_lego_lint_warnings stays because it still finds lines to fix.
2026-09-14 12:47:54 +02:00
Vijay Janapa Reddi 888543954d content(vol3): align narrative threading and section coherence across Chapters 01-06 2026-09-13 14:20:47 +02:00
Vijay Janapa Reddi e8e7d356db Document every binder module, class, and function
Adds docstrings to the 900 definitions and 8 modules that had none across the binder CLI, its checks, and the audit and maintenance tools, and corrects a few docstrings that no longer matched the code. Only documentation changed.
2026-09-12 12:55:34 +02:00
Vijay Janapa Reddi a70aebd249 Move authoring tooling out of the repository
Removes content-authoring scripts, figure and data generators, and their working notes, which are not needed to build, check, or release the books and sites. The vault CLI drops the matching subcommands and doctor check; docs, comments, ignore rules, and the codegen hash are updated to match what remains.
2026-09-12 11:55:22 +02:00
Vijay Janapa Reddi 118a9e423f Clear stale references left from the old layout
- Remove two orphaned binder script docs: the citation-validation guide
  (the validator it describes is gone) and an AI formatting-preservation
  note that nothing links to.
- Drop ignore rules for book/_build/, physical/, and a root assignments/
  NBGrader block; none of those paths exist.
- pytest testpaths no longer lists a root tests/ directory.
- The contribution-guidelines links on the Volume I and II website pages
  point at the root CONTRIBUTING.md. The old book/docs/ path leaves main at
  the next publish. These are HTML-only; no PDF text changes.
2026-09-10 16:57:04 +02:00
Vijay Janapa Reddi 14ca66d2e9 Rename bindery/ to binder/ and run the CLI by its real path
The toolchain folder is now binder/, and the root ./binder symlink is gone.
The command is ./binder/binder: a plain path to the script, with no link and
no install step. Every invocation moved with it: pre-commit entries, workflow
steps, the VS Code extension's command palette, help text, and docs.

- bindery/ paths and bindery.* imports, including the chapter code cells
  that import binder.tools.figures, now name binder/.
- Binder (mybinder.org) reads its configuration from a root binder/ folder
  and refuses to build when binder/ and .binder/ both exist. .binder/postBuild
  and .binder/requirements.txt move into binder/, so the TinyTorch "Launch
  Binder" buttons keep working; binder/README.md records which file names the
  toolchain must not use there.
- contributors/projects.json still pointed the book's contributor record at
  publishing/; it now names binder/, where that .all-contributorsrc lives.
- The margin-figure reader-link audit report linked its 222 figures through
  the retired quarto/ tree; the links now resolve under books/.

The hooks reformatted hidden Python cells and trimmed whitespace in the
Volume II chapters whose figure imports this rename touches.

Checks: ./binder/binder check cli passes (contract and canonical hooks),
binder.tools.figures imports, and every workflow YAML file parses.

binder test suite, excluding the four modules that cannot import mlsysim
through the root symlink (fixed separately): 7 failed, 346 passed.

The GitHub repository variables BOOK_ROOT, BOOK_TOOLS, BOOK_DEPS, and
BOOK_DOCKER still name the retired book/ layout and must change when this
reaches origin.
2026-09-10 15:26:07 +02:00