mirror of
https://github.com/harvard-edge/cs249r_book.git
synced 2026-05-06 01:28:35 -05:00
eec7e47929
Replace duplicated navbar/mobile responsive rules in satellite sites (instructors, kits, labs, mlsysim, slides) with a single import of shared/styles/partials/_mobile.scss. Removes ~169 lines of copy-pasted CSS that would drift out of sync when the shared partial is updated. - instructors: remove rogue desktop padding, add _mobile import - kits: remove ~50 lines of duplicated mobile rules, add _mobile import - labs: remove ~55 lines of duplicated mobile rules, add _mobile import - mlsysim: remove ~55 lines of duplicated mobile rules, add _mobile import - slides: add _mobile import (had no mobile rules before)
🗺️ The Blueprint — Instructor Site
Status: Under Active Development
This site is being actively built and refined. Content, structure, and styling may change frequently. SVG diagrams are placeholder quality and will be professionally refined before launch.
📖 What This Is
"The Blueprint" is the instructor-facing companion site for the ML Systems textbook. It provides everything needed to teach AI Engineering as a university course.
| 📅 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 1.4+.
📂 File Structure
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 (
#6366f1light,#818cf8dark) - 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.