7 Commits
Author SHA1 Message Date
Vijay Janapa Reddi 674117c2e3 Unify Volume 1-4 bibliographies into demarcated master references.bib 2026-09-30 21:07:26 -04:00
Vijay Janapa Reddi cc6272b50c feat(vol3): streamline introduction chapter and consolidate bibliography
- Refine Chapter 01 to serve as a focused architectural introduction without premature deep dives or duplicate walkthroughs.
- Remove compounding reliability wall and SWE-bench scaling charts from Sections 1.2 and 1.3, articulating reliability dynamics in prose.
- Streamline Section 1.5 closed-loop execution and eliminate redundant trajectory systems boundary diagram.
- Streamline Section 1.6 fail-plausible fault model by removing duplicate war story and request scope diagram.
- Convert Section 1.7 task specification contract into concise narrative prose, removing definition box and specification table.
- Maintain fallacies and pitfalls as a foundational architectural bookend across the stochastic computer subsystems.
- Distribute all 8 biographical footnotes (von Neumann, Wilkes, Karpathy, Gray, Lamport, Saltzer, Amdahl, Denning) evenly across page margins with zero collisions.
- Consolidate Volume 3 bibliography onto canonical books/references.bib and retire references-vol3.bib.
2026-09-17 13:54:31 +02:00
Vijay Janapa Reddi ed341f9c8b refactor(vol2): standardize Volume II title to Scaling Machine Learning Systems 2026-09-14 22:25:38 +02:00
Vijay Janapa Reddi 26cb1f73ff build(vol3): reconcile configurations, streamline listing heights, and achieve clean PDF and HTML builds
- Update Quarto configurations (PDF, HTML, EPUB) and shared STRUCTURE.md with aligned Part and Chapter paths
- Extend build_volume_bib.py to resolve Quarto include directives for robust bibliography generation
- Streamline code listings across Chapters 01-05 to algorithmic invariants, eliminating listing-induced PDF trim overflows
- Fix math and inline Python formatting in Chapter 05 to comply with strict markup validators
- Verify 100% pass across all 37 binder check groups, zero post-build trim violations, and clean HTML/PDF builds
2026-09-13 15:36:56 +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 5a66c935f1 Fix book build failures and harden book checks
- Vol II: close the margin note wrapping the storage-compute figure,
  move the bandwidth figure out of its callout, and separate the NPU
  figure from the preceding footnote so all three cross-references
  resolve; widen Table 11.3 so it stays inside the page trim.
- Landing pages: hide the download card, star counter, and podcast from
  EPUB output and point the cover and podcast at shared/assets.
- Vol I/II frontmatter image paths, table column widths, Vol III
  equation labels, Vol IV lint fixes and SVG newline repairs, and
  regenerated volume bibliographies.
- Bibliography integrity scan ignores math spans; currency check skips
  render caches; Prentice Hall joins the canonical publisher list.
- Unprefixed chapter URLs publish redirect stubs to numbered pages.
- Remove stray test files, duplicate quiz files, unused cover options,
  generated figure lists, and outdated review scripts; drop generator
  metadata from quiz files.
- Repoint documentation at current chapter paths and deduplicate
  pre-commit file patterns.
2026-09-12 09:17:53 +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