Commit Graph

25 Commits

Author SHA1 Message Date
Vijay Janapa Reddi
96fa7ac5e5 chore: bump Quarto to 1.9.27 and R to 4.5.2
- Quarto 1.9.27: Linux (.deb), Windows (direct download; Scoop Extras has 1.8.27)
- R 4.5.2: Linux (CRAN jammy-cran40), Windows (Scoop main/r)
- Baremetal: quarto-actions/setup for both Linux and Windows
- Remove ggrepel version pin (R 4.5.x supports ggrepel 0.9.7)
- Update docs: BUILD.md, CONTAINER_BUILDS.md, docker READMEs
2026-03-02 17:36:35 -05:00
Vijay Janapa Reddi
56e091f7e0 feat: standardize System Archetypes in Vol 1 and Vol 2; add canonical roster table to Introductions; ensure tight math-prose integration 2026-02-24 20:23:50 -05:00
Vijay Janapa Reddi
09602445de chore: update book content, config, appendices, and tooling
- Vol1: chapter updates across backmatter, benchmarking, data, frameworks, etc.
- Vol2: content updates, new appendices (assumptions, communication, fleet, reliability)
- Quarto: config, styles, formulas, constants
- Add SEMINAL_PAPERS_V2.md, learning_objectives_bolding_parallel.sh
- VSCode extension: package.json, chapterNavigatorProvider
- Landing page and docs updates
2026-02-20 18:55:24 -05:00
Vijay Janapa Reddi
2390c3ab31 Refactor: consolidate Quarto config layers and content reorganization.
Unifies Quarto metadata into shared base/format/volume fragments while carrying through chapter path, asset, and tooling updates to keep the repository consistent and easier to maintain.
2026-02-12 15:38:55 -05:00
Vijay Janapa Reddi
ff3797a1d8 Refactor: Finalize Volume 1 and update CLI/VSCode tooling
- Completed full Volume 1 refactor to Safe Class Namespace pattern.

- Fixed render errors and verified all 16 chapters.

- Updated 'binder' CLI with native validation and maintenance namespaces.

- Enhanced VS Code extension with Chapter Navigator and Run History.

- Integrated 'binder validate' into pre-commit workflows.
2026-02-11 09:25:50 -05:00
Vijay Janapa Reddi
3750ee12e9 Enforce Computed Arithmetic Rule across all chapters (1,064 inline refs, 0 unresolved)
Replace every hand-typed derived number with Python-computed inline
references. Add just-in-time compute cells before prose so that changing
any input constant automatically propagates to all derived values.

Vol 1 chapters fixed: dl_primer, dnn_architectures, serving,
model_compression, hw_acceleration, benchmarking, ops, appendix_machine,
appendix_data, frameworks, data_engineering, training, ml_systems,
responsible_engr, data_selection, workflow, introduction.

Vol 2 chapters fixed: distributed_training, inference, infrastructure,
storage, sustainable_ai, fault_tolerance, ops_scale, edge_intelligence,
ai_for_good, privacy_security.

Key corrections caught by forcing computation:
- training.qmd carbon footprint: 64 GPUs → 1024 GPUs (original was
  mathematically impossible for 7B params × 1T tokens)
- hw_acceleration.qmd systolic energy: 10 pJ/250× → 11 pJ/233× (exact)
- hw_acceleration.qmd GPT-2 utilization: 0.6% → 0.7% (exact)
- serving.qmd tokens/hour: ~190M → ~192M (exact)

Also adds calc/validate_inline_refs.py pre-render guardrail and
extends calc/viz.py with Harvard Crimson plotting palette.
2026-02-01 11:13:42 -05:00
Vijay Janapa Reddi
e3d4deeb12 Standardize volume titles to full 'Machine Learning Systems' naming
Replaces abbreviated 'ML Systems' with 'Machine Learning Systems' across
volume titles, part openers, frontmatter, summaries, docs, and landing page
for consistency with MIT Press submission standards.
2026-01-31 19:45:52 -05:00
Vijay Janapa Reddi
26e9b65db1 Merge latest dev updates into feat/volume-restructure 2026-01-21 19:30:00 -05:00
Vijay Janapa Reddi
149d945a51 Add per-project All Contributors setup
Set up separate contributor tracking for each sub-project:
- book/.all-contributorsrc - Book content contributors
- kits/.all-contributorsrc - Hardware kit contributors
- labs/.all-contributorsrc - Lab exercise contributors
- tinytorch/.all-contributorsrc - Framework contributors

Each project now has:
- Its own .all-contributorsrc config file
- Contributors section in README with All Contributors format
- Project-specific contribution types in the recognition guide
- Cheatsheet in CONTRIBUTING.md (where applicable)

Added @AmirAlasady as first TinyTorch contributor for bug report #1122.

Usage: Comment on any issue/PR with:
@all-contributors please add @username for bug, code, doc, or ideas
2026-01-20 13:35:00 -05:00
Vijay Janapa Reddi
9a44d0ea16 Removes learning objectives framework
Removes the learning objectives framework, part key validation system, and the publish live workflow documentation.

These files are being removed to facilitate a reorganization of the project's documentation structure and workflows.
2026-01-07 11:57:35 -05:00
Vijay Janapa Reddi
da8e419df6 Merge dev: bring in infrastructure changes
- Cloudflare migration (Netlify removed)
- Book deployed to /book/
- Publish All workflow
- gh-pages cleanup
- Changelog deprecated
- MIT Press reviewer feedback
- Labs rename (collabs -> labs)
2026-01-06 15:24:07 -05:00
Vijay Janapa Reddi
8160d5869c refactor: deprecate CHANGELOG.md in favor of GitHub Releases
- Remove CHANGELOG.md from repo root
- Remove changelog.qmd page from book frontmatter
- Remove changelog from navbar in HTML, PDF, and EPUB configs
- Delete changelog generation scripts (generate_release_content.py, etc.)
- Update documentation to remove changelog references

GitHub Releases now serves as the primary changelog for version updates.
The version number in the navbar already links to releases.
2026-01-06 11:31:35 -05:00
Vijay Janapa Reddi
cdcb4e9529 chore: remove volume-splitting strategy docs from public repo
These files contain internal planning documents that should not be
public:
- VOLUME_SPLIT_ROADMAP.md (project timeline and MIT Press plans)
- VOLUME_SPLIT_SURGICAL_PLAN.md (section-by-section surgery)
- VOLUME_STRUCTURE_PROPOSAL.md (publisher proposal draft)
2026-01-04 18:07:27 -05:00
Vijay Janapa Reddi
c6a3036151 docs: update AI Triangle to AI Triad in learning objectives framework
Align documentation with the renamed framework terminology used
throughout both volumes of the textbook.
2026-01-03 13:45:37 -05:00
Vijay Janapa Reddi
95e0eafcdc refactor: rename Vol I tagline from Operate to Deploy
Update Volume I tagline from "Build, Optimize, Operate" to
"Build, Optimize, Deploy" across all documentation.

- "Deploy" better matches Part IV content (Serving, MLOps, Responsible Engineering)
- "Operate" implies ongoing management which is more Volume II territory
- Also fixes hw_acceleration table to use proper grid table format
2026-01-03 10:09:19 -05:00
Vijay Janapa Reddi
773897c07d refactor: restructure Vol II chapters and add Vol I serving chapter
This commit consolidates several structural changes:

1. Merge ondevice_learning into edge_intelligence chapter
   - Add support files (bib, concepts, glossary, quizzes)
   - Add images from former ondevice_learning
   - Update all cross-references from @sec-ondevice-learning to @sec-edge-intelligence

2. Delete Vol II hw_acceleration chapter (merged into distributed_training)

3. Add new Serving chapter to Vol I Part IV (Deployment)
   - Create placeholder serving.qmd with section structure
   - Add support files for bibliography, concepts, glossary, quizzes

4. Update configs and documentation
   - Update _quarto-html.yml with serving chapter in sidebar and bibliography
   - Update VOLUME_STRUCTURE.md to reflect 16 chapters in Vol I
   - Update About page with simplified Part names
   - Fix table formatting in hw_acceleration chapter

Vol I now has 16 chapters (4 in each Part) matching Vol II structure.
2026-01-03 10:01:25 -05:00
Vijay Janapa Reddi
ddb8068e6b docs: remove stale volume planning documents
Remove outdated planning documents that have been superseded by
VOLUME_STRUCTURE.md which now serves as the authoritative reference
for the two-volume textbook organization.

Removed files:
- VOLUME_SPLIT_ROADMAP.md
- VOLUME_SPLIT_SURGICAL_PLAN.md
- VOLUME_STRUCTURE_PROPOSAL.md
- reviewer-feedback-synthesis-r1.md
- volume-outline-draft.md
2026-01-03 09:57:16 -05:00
Vijay Janapa Reddi
f3a38e32d5 refactor: simplify Vol I Part names to single words
Change Part names from compound to single-word format:
- ML Foundations → Foundations
- System Development → Development
- Model Optimization → Optimization
- System Operations → Deployment

Creates clean pedagogical progression: Foundations → Development → Optimization → Deployment
2026-01-03 09:31:19 -05:00
Vijay Janapa Reddi
0266ee24bc docs: add approved two-volume structure outline
Volume I: Introduction to ML Systems (14 chapters)
- Part I: Foundations (Ch 1-4)
- Part II: Development (Ch 5-8)
- Part III: Optimization (Ch 9-12)
- Part IV: Operations (Ch 13-14)

Volume II: Advanced ML Systems (16 chapters)
- Part I: Foundations of Scale (Ch 1-4)
- Part II: Distributed Systems (Ch 5-8)
- Part III: Production Challenges (Ch 9-12)
- Part IV: Responsible Deployment (Ch 13-16)

Structure approved for website implementation.
2025-12-31 08:50:49 -05:00
Vijay Janapa Reddi
853eb03ee8 style: apply consistent whitespace and formatting across codebase 2025-12-13 14:05:34 -05:00
Vijay Janapa Reddi
96d487f211 docs: restructure READMEs for book and TinyTorch integration
- Root README: Add ML-Systems bridge table, book structure, and what makes this book different
- book/README: Simplify to build instructions for contributors
- tinytorch/README: Streamline with correct clone URL and Early Access status
- Rename contribute.md to CONTRIBUTING.md for consistency
2025-12-10 06:35:58 -08:00
Vijay Janapa Reddi
bee262de3e docs: add comprehensive volume split planning documents
- Add MIT_PRESS_PROPOSAL.md: polished proposal for two-volume series
- Add VOLUME_SPLIT_ROADMAP.md: 6-month master project plan with progress tracking
- Add VOLUME_SPLIT_SURGICAL_PLAN.md: detailed section-by-section surgery instructions

These documents establish the complete roadmap for splitting the ML Systems
textbook into two flagship volumes for MIT Press publication.
2025-12-07 06:54:55 -08:00
Vijay Janapa Reddi
6330421ffd docs: update volume structure proposal
Updated volume organization and structure planning document
2025-12-07 06:07:52 -08:00
Vijay Janapa Reddi
56a5abff0f docs: add volume structure proposal and distribution design docs
- book/docs/VOLUME_STRUCTURE_PROPOSAL.md: Proposal for textbook volume structure
- tinytorch/docs/DISTRIBUTION_DESIGN.md: Design document for TinyTorch pip distribution
2025-12-06 21:20:57 -08:00
Vijay Janapa Reddi
7b92e11193 Repository Restructuring: Prepare for TinyTorch Integration (#1068)
* Restructure: Move book content to book/ subdirectory

- Move quarto/ → book/quarto/
- Move cli/ → book/cli/
- Move docker/ → book/docker/
- Move socratiQ/ → book/socratiQ/
- Move tools/ → book/tools/
- Move scripts/ → book/scripts/
- Move config/ → book/config/
- Move docs/ → book/docs/
- Move binder → book/binder

Git history fully preserved for all moved files.

Part of repository restructuring to support MLSysBook + TinyTorch.

Pre-commit hooks bypassed for this commit as paths need updating.

* Update pre-commit hooks for book/ subdirectory

- Update all quarto/ paths to book/quarto/
- Update all tools/ paths to book/tools/
- Update config/linting to book/config/linting
- Update project structure checks

Pre-commit hooks will now work with new directory structure.

* Update .gitignore for book/ subdirectory structure

- Update quarto/ paths to book/quarto/
- Update assets/ paths to book/quarto/assets/
- Maintain all existing ignore patterns

* Update GitHub workflows for book/ subdirectory

- Update all quarto/ paths to book/quarto/
- Update cli/ paths to book/cli/
- Update tools/ paths to book/tools/
- Update docker/ paths to book/docker/
- Update config/ paths to book/config/
- Maintain all workflow functionality

* Update CLI config to support book/ subdirectory

- Check for book/quarto/ path first
- Fall back to quarto/ for backward compatibility
- Maintain full CLI functionality

* Create new root and book READMEs for dual structure

- Add comprehensive root README explaining both projects
- Create book-specific README with quick start guide
- Document repository structure and navigation
- Prepare for TinyTorch integration
2025-12-05 14:04:21 -08:00