Commit Graph

8 Commits

Author SHA1 Message Date
Vijay Janapa Reddi
1f951c2120 Improve kits section table formatting
Update tables in hardware kits documentation with proper formatting.
2026-01-21 17:12:14 -05:00
Vijay Janapa Reddi
c0a91c0467 fix(kits): repair broken lab links and clarify XIAOML Kit terminology
Lab links using @sec-... cross-references were not resolving in
markdown links, causing 404 errors. Replaced with relative file paths.

Also clarified the distinction between XIAO ESP32S3 Sense (Vision/Sound)
and XIAOML Kit (Vision/Sound/Motion via expansion board IMU) throughout
the kits documentation for consistency.
2026-01-07 08:33:40 -05:00
Vijay Janapa Reddi
2f9bde47ea cleanup: remove macOS metadata files from kits
Remove 23 accidentally committed ._*xref.json files that are
macOS resource fork metadata. These files serve no purpose in
the repository and clutter the codebase.
2026-01-04 07:21:37 -05:00
Vijay Janapa Reddi
312f7c8dbd docs: add purchase links to platform overview pages
Add "Where to Buy" section to each hardware platform overview page
with direct links to official vendors and current pricing.
2025-12-28 10:06:40 -05:00
Vijay Janapa Reddi
1dd5d4897e fix: update hardware kit prices to December 2025 values
Updated prices across all pages based on current retailer pricing:
- XIAOML Kit: ~$40 (was $15-50)
- Grove Vision AI V2: ~$25 (was $20-30)
- Arduino Nicla Vision: ~$95 (was $100-120)
- Raspberry Pi: $60-145 (reflects 2025 price increases)

Also fixed carousel caption bar padding for even spacing.
2025-12-28 08:19:14 -05:00
Vijay Janapa Reddi
baf11336f8 refactor: improve Kits content organization per MIT Press standards
Getting Started:
- Restructured as step-by-step guide (Select → Setup → Choose Lab → Start)
- Added textbook connection section for academic context
- Clearer prerequisite expectations

Platforms:
- Renamed title from "Hardware Kits" to "Hardware Platforms" (avoid site title collision)
- Removed system requirements (moved to IDE Setup where they belong)
- Focused purely on hardware specifications and comparisons

IDE Setup:
- Added System Requirements section (moved from Platforms)
- Streamlined introduction
- Now contains all setup-related prerequisites in one place

Style:
- Improved carousel caption bar legibility (bolder text, larger font)
2025-12-27 18:07:54 -05:00
Vijay Janapa Reddi
754bd218df refactor: reorganize Kits content structure
Replaced old content files with new streamlined organization:
- getting-started.qmd: Concise hardware selection and lab navigation
- platforms.qmd: Detailed hardware specs and comparisons
- ide-setup.qmd: Development environment setup procedures

Removed old files:
- ide_setup.qmd (replaced by ide-setup.qmd)
- kits.qmd (content moved to platforms.qmd)
- labs.qmd (content redistributed)

Getting Started is now action-oriented rather than pedagogical.
2025-12-27 18:00:29 -05:00
Vijay Janapa Reddi
029d99fb81 refactor: extract hardware labs to standalone kits project
Monorepo restructuring for better build performance and separation of concerns:

- Create kits/ as standalone Quarto project with teal accent styling
- Add _brand/ directory with shared design tokens (tokens.scss)
- Move labs from book/quarto/contents/labs/ to kits/contents/
- Remove labs sections (Parts VII-XII) from book sidebar
- Add CI/CD workflows for kits (kits-publish-live.yml, kits-publish-dev.yml)
- Update netlify.toml redirects: /labs -> /kits/
- Add Volume I/II test sidebar config for future use

Deployment URLs:
- Textbook: mlsysbook.ai/
- Kits: mlsysbook.ai/kits/
- TinyTorch: mlsysbook.ai/tinytorch/

All three projects build independently and successfully.
2025-12-24 10:54:41 -05:00