Skip to content

Update Eclipse docs with new Tokens section#7637

Merged
beseku merged 6 commits intomainfrom
reorganise-eclipse-docs
Mar 12, 2026
Merged

Update Eclipse docs with new Tokens section#7637
beseku merged 6 commits intomainfrom
reorganise-eclipse-docs

Conversation

@beseku
Copy link
Contributor

@beseku beseku commented Mar 12, 2026

Summary

  • Flatten atoms/molecules into a single Components section — all 33 component docs now live under components/ with an alphabetical listing in the sidebar, replacing the previous
    atoms/molecules split
  • Add a Tokens section with documentation for Colors (moved from top-level), Typography (derived from type-* utility classes), and Spacing (margin and element tokens) — each with
    live previews and reference tables
  • Update sidebar meta.json to reflect the new Tokens and Components structure

Test plan

  • Verify the Eclipse docs dev server starts without errors (pnpm dev)
  • Confirm all component pages render at their new /components/* URLs
  • Confirm Tokens section appears in sidebar with Colors, Spacing, and Typography pages
  • Check that typography live previews render correctly with the correct fonts/weights
  • Check that spacing visualizations (bars and squares) render at correct sizes
  • Verify no broken internal links (pnpm lint:links)

Summary by CodeRabbit

  • New Features

    • Added comprehensive spacing and typography token docs and a Tokens catalog.
    • Added a Components catalog for the design system.
  • Documentation

    • Reorganized design system navigation from Atoms/Molecules to Tokens/Components.
    • Updated the main design system introduction and trimmed Colors page intro.
  • Chores

    • Removed legacy Atoms and Molecules metadata files.

@vercel
Copy link

vercel bot commented Mar 12, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
blog Ready Ready Preview, Comment Mar 12, 2026 7:36pm
docs Ready Ready Preview, Comment Mar 12, 2026 7:36pm
eclipse Ready Ready Preview, Comment Mar 12, 2026 7:36pm

Request Review

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Mar 12, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: a5efc94a-b41b-4c88-90a8-8f5ece23ff3a

📥 Commits

Reviewing files that changed from the base of the PR and between 49cfdb4 and 77b2840.

📒 Files selected for processing (4)
  • apps/eclipse/content/design-system/components/meta.json
  • apps/eclipse/content/design-system/tokens/meta.json
  • apps/eclipse/content/design-system/tokens/spacing.mdx
  • apps/eclipse/content/design-system/tokens/typography.mdx
🚧 Files skipped from review as they are similar to previous changes (4)
  • apps/eclipse/content/design-system/components/meta.json
  • apps/eclipse/content/design-system/tokens/typography.mdx
  • apps/eclipse/content/design-system/tokens/meta.json
  • apps/eclipse/content/design-system/tokens/spacing.mdx

Walkthrough

Restructures the Eclipse Design System docs: removes Atoms and Molecules metadata files, adds Tokens and Components metadata, updates root meta.json and index.mdx, and introduces new Tokens docs for spacing and typography plus a small change to colors content.

Changes

Cohort / File(s) Summary
Root & Section Metadata
apps/eclipse/content/design-system/meta.json, apps/eclipse/content/design-system/index.mdx
Reordered/rewrote the design-system root metadata to replace Atom/Molecule groupings with Tokens and Components; index.mdx description condensed and heading removed.
Removed Section Manifests
apps/eclipse/content/design-system/atoms/meta.json, apps/eclipse/content/design-system/molecules/meta.json
Deleted static metadata files that previously defined the Atoms and Molecules collections and their page lists.
New Section Manifests
apps/eclipse/content/design-system/components/meta.json, apps/eclipse/content/design-system/tokens/meta.json
Added new JSON metadata files defining the Components and Tokens sections with titles, descriptions, icons, and pages arrays.
Token Documentation
apps/eclipse/content/design-system/tokens/colors.mdx, apps/eclipse/content/design-system/tokens/spacing.mdx, apps/eclipse/content/design-system/tokens/typography.mdx
Minor edit to colors intro; added spacing tokens MDX (detailed Margin/Element tokens with tables and usage) and typography tokens MDX (font families, headings, text, code examples).

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately captures the primary change: reorganizing Eclipse documentation with a new Tokens section alongside a restructured Components grouping.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

📝 Coding Plan for PR comments
  • Generate coding plan

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@argos-ci
Copy link

argos-ci bot commented Mar 12, 2026

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build Status Details Updated (UTC)
default (Inspect) ⚠️ Changes detected (Review) 1 removed Mar 12, 2026, 7:33 PM

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (2)
apps/eclipse/content/design-system/tokens/meta.json (1)

3-3: Minor grammatical improvement in description.

The phrase "Design tokens components" reads awkwardly. Consider simplifying to maintain consistency with the Components meta.json style.

✏️ Suggested fix
-  "description": "Design tokens components in the Eclipse Design System",
+  "description": "Design tokens in the Eclipse Design System",
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@apps/eclipse/content/design-system/tokens/meta.json` at line 3, Update the
"description" value in meta.json to a clearer, grammatically correct phrase —
replace "Design tokens components in the Eclipse Design System" with something
like "Design tokens for the Eclipse Design System" or "Design tokens in the
Eclipse Design System"; locate the "description" key in the file to make the
change so it matches the Components meta.json style.
apps/eclipse/content/design-system/tokens/typography.mdx (1)

32-32: Consider simplifying phrasing.

The phrase "with the exception of" is correct but a bit verbose for documentation. A simpler alternative reads more smoothly.

✏️ Suggested simplification
-Heading styles use the **Mona Sans VF** display font, with the exception of `heading-2xs`. Use these styles only for headings.
+Heading styles use the **Mona Sans VF** display font, except for `heading-2xs`. Use these styles only for headings.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@apps/eclipse/content/design-system/tokens/typography.mdx` at line 32, The
sentence "Heading styles use the **Mona Sans VF** display font, with the
exception of `heading-2xs`. Use these styles only for headings." is wordy;
replace "with the exception of" with the simpler "except" so it reads "Heading
styles use the **Mona Sans VF** display font, except `heading-2xs`. Use these
styles only for headings." Update the copy where that exact string appears
(reference: the heading token `heading-2xs`) to use the simplified phrasing.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@apps/eclipse/content/design-system/tokens/spacing.mdx`:
- Line 211: The class name contains a typo: replace the double-dash token
"min-h--element-xl" with the correct "min-h-element-xl" in the JSX element so it
matches the project's single-dash spacing tokens (see other tokens like
h-element-xl, w-element-3xl, size-element-xl used in button.tsx and avatar.tsx);
update the className string inside the component to the single-dash variant to
restore consistent naming and Tailwind/CSS-token compatibility.

---

Nitpick comments:
In `@apps/eclipse/content/design-system/tokens/meta.json`:
- Line 3: Update the "description" value in meta.json to a clearer,
grammatically correct phrase — replace "Design tokens components in the Eclipse
Design System" with something like "Design tokens for the Eclipse Design System"
or "Design tokens in the Eclipse Design System"; locate the "description" key in
the file to make the change so it matches the Components meta.json style.

In `@apps/eclipse/content/design-system/tokens/typography.mdx`:
- Line 32: The sentence "Heading styles use the **Mona Sans VF** display font,
with the exception of `heading-2xs`. Use these styles only for headings." is
wordy; replace "with the exception of" with the simpler "except" so it reads
"Heading styles use the **Mona Sans VF** display font, except `heading-2xs`. Use
these styles only for headings." Update the copy where that exact string appears
(reference: the heading token `heading-2xs`) to use the simplified phrasing.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 77d560e9-df6f-4a01-8429-d4f938993e8f

📥 Commits

Reviewing files that changed from the base of the PR and between 0f1bc35 and 49cfdb4.

📒 Files selected for processing (41)
  • apps/eclipse/content/design-system/atoms/meta.json
  • apps/eclipse/content/design-system/components/accordion.mdx
  • apps/eclipse/content/design-system/components/action.mdx
  • apps/eclipse/content/design-system/components/alert.mdx
  • apps/eclipse/content/design-system/components/avatar.mdx
  • apps/eclipse/content/design-system/components/badge.mdx
  • apps/eclipse/content/design-system/components/banner.mdx
  • apps/eclipse/content/design-system/components/breadcrumb.mdx
  • apps/eclipse/content/design-system/components/button.mdx
  • apps/eclipse/content/design-system/components/card.mdx
  • apps/eclipse/content/design-system/components/chart.mdx
  • apps/eclipse/content/design-system/components/checkbox.mdx
  • apps/eclipse/content/design-system/components/codeblock.mdx
  • apps/eclipse/content/design-system/components/dialog.mdx
  • apps/eclipse/content/design-system/components/dropdownmenu.mdx
  • apps/eclipse/content/design-system/components/field.mdx
  • apps/eclipse/content/design-system/components/files.mdx
  • apps/eclipse/content/design-system/components/inlinetoc.mdx
  • apps/eclipse/content/design-system/components/input.mdx
  • apps/eclipse/content/design-system/components/label.mdx
  • apps/eclipse/content/design-system/components/meta.json
  • apps/eclipse/content/design-system/components/pagination.mdx
  • apps/eclipse/content/design-system/components/radio-group.mdx
  • apps/eclipse/content/design-system/components/separator.mdx
  • apps/eclipse/content/design-system/components/slider.mdx
  • apps/eclipse/content/design-system/components/spinner.mdx
  • apps/eclipse/content/design-system/components/statistic.mdx
  • apps/eclipse/content/design-system/components/steps.mdx
  • apps/eclipse/content/design-system/components/switch.mdx
  • apps/eclipse/content/design-system/components/table.mdx
  • apps/eclipse/content/design-system/components/tabs.mdx
  • apps/eclipse/content/design-system/components/textarea.mdx
  • apps/eclipse/content/design-system/components/tooltip.mdx
  • apps/eclipse/content/design-system/components/typetable.mdx
  • apps/eclipse/content/design-system/index.mdx
  • apps/eclipse/content/design-system/meta.json
  • apps/eclipse/content/design-system/molecules/meta.json
  • apps/eclipse/content/design-system/tokens/colors.mdx
  • apps/eclipse/content/design-system/tokens/meta.json
  • apps/eclipse/content/design-system/tokens/spacing.mdx
  • apps/eclipse/content/design-system/tokens/typography.mdx
💤 Files with no reviewable changes (2)
  • apps/eclipse/content/design-system/atoms/meta.json
  • apps/eclipse/content/design-system/molecules/meta.json

@beseku beseku merged commit f46efe2 into main Mar 12, 2026
4 of 10 checks passed
@beseku beseku deleted the reorganise-eclipse-docs branch March 12, 2026 19:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant