Files
cs249r_book/site/README.md
Vijay Janapa Reddi eb27858591 docs(readmes): replace HTML card pattern with native GitHub callouts
The sub-project READMEs used an old-school nested-table card design
with hardcoded bgcolor="#ffffff", "#cfd6dd", "#eef2f7" plus deprecated
HTML4 attributes (cellpadding, cellspacing, border). It looked good in
light mode but produced harsh white islands in GitHub's dark theme,
which is what most readers see today.

Across 11 sub-READMEs:

- Strip the card wrapper so data tables are just clean
  <table width="100%"> with semantic <thead>/<tbody>. Headers keep
  their column widths; bgcolor/valign/zebra-stripe cruft is removed
  (GitHub provides its own theme-aware striping).
- Convert the early-release callouts (and mlperf-edu's two-tier
  status block + "source of truth" note + interviews' two info boxes)
  to GitHub-native > [!NOTE] / > [!WARNING] / > [!TIP] callouts.
  These are theme-aware, get proper icons, and render correctly in
  light AND dark mode.

Net result: 528 lines of HTML cruft removed, 230 lines of clean
markdown added. Visual identity is preserved (callouts still stand
out, tables still stretch full-width) while becoming dark-mode safe
and consistent with the main README.
2026-04-22 16:12:20 -04:00

1.1 KiB

MLSysBook — Unified site (landing)

This directory is the Quarto source for the public landing and community experience at mlsysbook.ai: home, about, community, newsletter sync, and related shared pages (together with assets under shared/).


Note

📌 Early release (2026)

The unified site shipped with the 2026 MLSysBook refresh. Information architecture, copy, newsletter wiring, and styling are actively iterated as the book and sibling projects evolve.

FeedbackGitHub issues or pull requests.

dev branch live site

For build and deploy, see .github/workflows/site-validate-dev.yml and site-publish-live.yml in this repository.