Merge dev into main

Author: profvjreddi

.all-contributorsrc

@@ -698,4 +698,4 @@
     "repoHost": "https://github.com",
     "commitConvention": "angular",
     "skipCi": true
-}
+}

.github/workflows/tinytorch-build-pdfs.yml

@@ -48,6 +48,14 @@ jobs:
           cache: 'pip'
           cache-dependency-path: 'tinytorch/site/requirements.txt'
 
+      - name: 🟢 Setup Node.js (for Mermaid)
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: 📦 Install Mermaid CLI
+        run: npm install -g @mermaid-js/mermaid-cli
+
       - name: 📦 Install dependencies
         working-directory: tinytorch
         run: |

.pre-commit-config.yaml

@@ -22,11 +22,14 @@ repos:
     hooks:
       - id: trailing-whitespace
         name: "Global: Trim trailing whitespace"
+        # Only run on markdown files to avoid breaking templates, extensions, etc.
+        files: "\\.(md|qmd)$"
         exclude: "^(_site/|_book/|node_modules/)"
       - id: end-of-file-fixer
         name: "Global: Fix end of file newlines"
-        # Exclude .bib files as bibtex-tidy handles them separately
-        exclude: "^(_site/|_book/|node_modules/)|.*\\.bib$"
+        # Only run on markdown files to avoid breaking templates, extensions, etc.
+        files: "\\.(md|qmd)$"
+        exclude: "^(_site/|_book/|node_modules/)"
       - id: check-json
         name: "Global: Validate JSON syntax"
       - id: check-yaml
@@ -38,8 +41,8 @@ repos:
     hooks:
       - id: codespell
         name: "Global: Check for common misspellings"
-        args: ["--skip", "*.json,*.bib,*.min.js,*.tex,_site,_book,node_modules,.venv,htmlcov,bundle.js,glightbox.min.js", "--ignore-words", ".codespell-ignore-words.txt"]
-        exclude: "^(_site/|_book/|htmlcov/|.*bundle\\.js$|.*\\.min\\.js$)"
+        args: ["--skip", "*.json,*.bib,*.js,*.tex,_site,_book,node_modules,.venv,htmlcov", "--ignore-words", ".codespell-ignore-words.txt"]
+        exclude: "^(_site/|_book/|htmlcov/|.*\\.js$)"
 
   # ===========================================================================
   # SECTION 2: BOOK HOOKS (quarto content validation)

book/quarto/_extensions/mlsysbook-ext/titlepage/_titlepage.tex

@@ -210,3 +210,4 @@
 \clearpage
 $if(titlepage-geometry)$\restoregeometry
 $endif$%%% TITLE PAGE END
+

book/quarto/_extensions/mlsysbook-ext/titlepage/before-body.tex

@@ -36,3 +36,4 @@
 $endif$
 
 %%%%% end titlepage extension code
+

tinytorch/.git-hooks/pre-push

@@ -2,7 +2,7 @@
 # TinyTorch Pre-Push Hook
 # Prevents accidental pushes to the main TinyTorch repository
 
-UPSTREAM_REPO="github.com/mlsysbook/TinyTorch"
+UPSTREAM_REPO="github.com/harvard-edge/cs249r_book"
 PROTECTED_BRANCHES="main dev master"
 
 # Check if we're pushing to the upstream repo
@@ -20,7 +20,7 @@ if echo "$remote_url" | grep -q "$UPSTREAM_REPO"; then
                 echo "This is the upstream TinyTorch repository, not your personal fork."
                 echo ""
                 echo "If you're a student:"
-                echo "  1. Create your own fork: https://github.com/mlsysbook/TinyTorch/fork"
+                echo "  1. Create your own fork: https://github.com/harvard-edge/cs249r_book/fork"
                 echo "  2. Add your fork as a remote: git remote add my-fork <your-fork-url>"
                 echo "  3. Push to your fork: git push my-fork $branch_name"
                 echo ""

tinytorch/CONTRIBUTING.md

@@ -16,7 +16,7 @@ TinyTorch is an **educational framework** where every contribution should:
 
 1. **Clone and setup environment**:
    ```bash
-   git clone https://github.com/mlsysbook/TinyTorch.git
+   git clone https://github.com/harvard-edge/cs249r_book.git
    cd TinyTorch
    python -m venv .venv
    source .venv/bin/activate  # On Windows: .venv\Scripts\activate

tinytorch/INSTRUCTOR.md

@@ -11,7 +11,7 @@ TinyTorch teaches ML systems engineering through building, not just using. Stude
 ### **1. Initial Setup**
 ```bash
 # Clone and setup
-git clone https://github.com/MLSysBook/TinyTorch.git
+git clone https://github.com/harvard-edge/cs249r_book.git
 cd TinyTorch
 
 # Virtual environment (MANDATORY)
@@ -570,8 +570,8 @@ ls submitted/*/MODULE/
 ## 📚 Additional Resources
 
 - [MLSys Book](https://mlsysbook.ai) - Companion textbook
-- [Course Discussions](https://github.com/MLSysBook/TinyTorch/discussions)
-- [Issue Tracker](https://github.com/MLSysBook/TinyTorch/issues)
+- [Course Discussions](https://github.com/harvard-edge/cs249r_book/discussions)
+- [Issue Tracker](https://github.com/harvard-edge/cs249r_book/issues)
 
 ---
 

tinytorch/README.md

@@ -177,7 +177,7 @@ TinyTorch/
 │   ├── 06_optimizers/          # Module 06: SGD, Adam optimizers
 │   ├── 07_training/            # Module 07: Complete training loops
 │   ├── 08_dataloader/          # Module 08: Efficient data pipelines
-│   ├── 09_spatial/             # Module 09: Conv2d, MaxPool2d, CNNs
+│   ├── 09_convolutions/        # Module 09: Conv2d, MaxPool2d, CNNs
 │   ├── 10_tokenization/        # Module 10: Text processing
 │   ├── 11_embeddings/          # Module 11: Token & positional embeddings
 │   ├── 12_attention/           # Module 12: Multi-head attention

tinytorch/binder/README.md

@@ -24,7 +24,7 @@ When users click the "Launch Binder" button on any notebook page in the TinyTorc
 
 **Binder URL Format:**
 ```
-https://mybinder.org/v2/gh/mlsysbook/TinyTorch/main
+https://mybinder.org/v2/gh/harvard-edge/cs249r_book/main
 ```
 
 ### Google Colab
@@ -36,7 +36,7 @@ Colab launch buttons automatically:
 
 **Colab URL Format:**
 ```
-https://colab.research.google.com/github/mlsysbook/TinyTorch/blob/main/path/to/notebook.ipynb
+https://colab.research.google.com/github/harvard-edge/cs249r_book/blob/main/tinytorch/path/to/notebook.ipynb
 ```
 
 ## Testing
@@ -45,9 +45,9 @@ To test your Binder setup:
 
 1. **Test Binder Build:**
    ```bash
-   # Visit: https://mybinder.org/v2/gh/mlsysbook/TinyTorch/main
+   # Visit: https://mybinder.org/v2/gh/harvard-edge/cs249r_book/main
    # Or use the badge:
-   [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/mlsysbook/TinyTorch/main)
+   [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/harvard-edge/cs249r_book/main)
    ```
 
 2. **Verify Installation:**
@@ -71,7 +71,7 @@ To test your Binder setup:
 
 - Check `binder/requirements.txt` for syntax errors
 - Verify `binder/postBuild` has execute permissions (`chmod +x binder/postBuild`)
-- Review Binder build logs at: https://mybinder.org/v2/gh/mlsysbook/TinyTorch/main?urlpath=lab/tree/logs%2Fbuild.log
+- Review Binder build logs at: https://mybinder.org/v2/gh/harvard-edge/cs249r_book/main?urlpath=lab/tree/logs%2Fbuild.log
 
 ### Colab Import Errors