🗺️ The Blueprint — Instructor Site

> [!NOTE] > **📌 Early release (2026)** > > This instructor site shipped with the **2026** MLSysBook refresh and is **actively iterated**: syllabi, rubrics, layouts, and diagrams (including SVGs) will keep improving as we teach from it. > > **Feedback** — [GitHub issues](https://github.com/harvard-edge/cs249r_book/issues) or pull requests. --- ## 📖 What This Is "The Blueprint" is the instructor-facing companion site for the [ML Systems textbook](https://mlsysbook.ai). It provides everything needed to teach AI Engineering as a university course.

Area	What you get
📅 Syllabi	Week-by-week syllabi for two semesters (Foundations + Scale).
⚖️ Assessment	Assessment rubrics with sample student work.
🧠 Pedagogy	Pedagogy guide with learning science and facilitation strategies.
👨‍🏫 TA Guide	TA training guide with grading workflows and common student struggles.
⚙️ Config	Customization guide for quarters, seminars, and different emphases.
❓ FAQ	FAQ for adopting instructors.

--- ## 🛠️ Building Locally cd instructors/ quarto preview Requires [Quarto](https://quarto.org/) 1.4+. --- ## 📂 File Structure ```text instructors/ ├── _quarto.yml # Site configuration ├── index.qmd # Landing page (hero + overview) ├── getting-started.qmd # 8-step adoption checklist ├── course-map.qmd # Integration matrix + SVG diagrams ├── foundations-syllabus.qmd # Semester 1: 16-week schedule ├── scale-syllabus.qmd # Semester 2: 16-week schedule ├── pedagogy.qmd # Learning science + facilitation ├── assessment.qmd # Rubrics + sample work ├── ta-guide.qmd # TA training + grading workflows ├── customization.qmd # Quarter/seminar/emphasis variants ├── faq.qmd # Common instructor questions └── assets/ # Styles and SVGs ``` --- ## 🎨 Style Conventions This site follows the MLSysBook ecosystem design system: * **Accent color**: Indigo (`#6366f1` light, `#818cf8` dark) * **Callout geometry**: 5px left border, 0.5rem radius, 8% opacity backgrounds * **Typography**: Inter (body), Outfit (headings), JetBrains Mono (code) * **Navbar**: Dark background (`#0a0a0f`), matching book sites See `assets/styles/style.scss` for full details. --- ## Contributors Thanks to these wonderful people who have helped build the Instructor Site! **Legend:** 🪲 Bug Hunter · ⚡ Code Warrior · 📚 Documentation Hero · 🎨 Design Artist · 🧠 Idea Generator · 🔎 Code Reviewer · 🧪 Test Engineer · 🛠️ Tool Builder

_{Vijay Janapa Reddi}
🧑‍💻 🎨 ✍️

_{Farhan Asghar}
🪲 🧑‍💻 🎨

_Rocky
🧑‍💻 ✍️ 🔎

**Recognize a contributor:** Comment on any issue or PR: ```text @all-contributors please add @username for code, design, doc in instructors ```