Skip to content

docs: modernize introduction page SVG figures#7352

Merged
saturley-hall merged 1 commit into
mainfrom
dagil-nvidia/docs-modernize-intro-figures
Mar 13, 2026
Merged

docs: modernize introduction page SVG figures#7352
saturley-hall merged 1 commit into
mainfrom
dagil-nvidia/docs-modernize-intro-figures

Conversation

@dagil-nvidia
Copy link
Copy Markdown
Collaborator

Summary

  • Modernize the two hand-crafted SVG figures on the introduction page (intro-foundations.svg and intro-perf.svg) to match the D2 theme 0 color scheme used by other docs diagrams
  • Add prefers-color-scheme CSS media queries for automatic light/dark mode switching

Details

The introduction page has two inline SVG diagrams (Venn foundations diagram, performance composability diagram) that were originally dark-mode-only with hardcoded colors. This PR updates them to:

  • D2 theme color palette: Uses N1/N2/B1/B5 tokens matching discovery-plane.svg and other D2-rendered diagrams
  • Light/dark mode: CSS @media (prefers-color-scheme: dark) overrides, same pattern as the dark mode patch in all D2 diagrams
  • Modern styling: Subtle drop shadows (feDropShadow), 1px strokes, rx=6 corners, 16px annotation text
  • NVIDIA Sans font: Font stack matches fern/docs.yml typography config with system fallbacks
  • Consistent text colors: All outside-box text uses N1 (dark in light mode, light in dark mode)

Where Should the Reviewer Start?

Open docs/assets/img/intro-foundations.svg and docs/assets/img/intro-perf.svg in a browser, toggle OS dark mode to verify both modes render correctly.

Test Plan

  • CI passes
  • SVGs render correctly in light mode (browser)
  • SVGs render correctly in dark mode (toggle OS appearance)
  • Fern docs preview shows figures inline on introduction page

Made with Cursor

- Add light/dark mode support via prefers-color-scheme CSS media queries
- Apply D2 theme 0 color palette (N1/N2/B1/B5 tokens) for consistency
  with other docs diagrams
- Add subtle drop shadows for modern depth effect
- Reduce stroke width from 2px to 1px for cleaner lines
- Reduce corner radius from 12px to 6px on perf diagram boxes
- Increase annotation text to 16px bold for better readability
- Update font stack to NVIDIA Sans with system fallbacks
- Make all text colors consistent (N1 for outside-box, white for
  inside accent fills)

Signed-off-by: Dan Gil <dagil@nvidia.com>
Made-with: Cursor
@github-actions github-actions Bot added docs documentation Improvements or additions to documentation labels Mar 13, 2026
@github-actions
Copy link
Copy Markdown
Contributor

@saturley-hall saturley-hall merged commit 19c192c into main Mar 13, 2026
47 checks passed
@saturley-hall saturley-hall deleted the dagil-nvidia/docs-modernize-intro-figures branch March 13, 2026 19:18
dagil-nvidia added a commit that referenced this pull request Mar 13, 2026
Signed-off-by: Dan Gil <dagil@nvidia.com>
saturley-hall pushed a commit that referenced this pull request Mar 13, 2026
…7352) (#7354)

Signed-off-by: Dan Gil <dagil@nvidia.com>
Signed-off-by: dagil-nvidia <dagil@nvidia.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: Neal Vaidya <nealv@nvidia.com>
ShounakRay pushed a commit to ShounakRay/fuzzy-dynamo that referenced this pull request Mar 20, 2026
Signed-off-by: Dan Gil <dagil@nvidia.com>
yao531441 pushed a commit to yao531441/dynamo that referenced this pull request May 13, 2026
Signed-off-by: Dan Gil <dagil@nvidia.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs documentation Improvements or additions to documentation size/L

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants