Skip to content

feat(design-data): add Articles section to Spectrum Design Data site - #1230

Open
GarthDB wants to merge 1 commit into
mainfrom
docs/design-tokens-articles-section
Open

feat(design-data): add Articles section to Spectrum Design Data site#1230
GarthDB wants to merge 1 commit into
mainfrom
docs/design-tokens-articles-section

Conversation

@GarthDB

@GarthDB GarthDB commented Jul 10, 2026

Copy link
Copy Markdown
Member

Description

Adds an "Articles" section to the Spectrum Design Data docs site (docs/site/), for release notes, roadmap posts, and in-depth concept/decision write-ups. Ships with a first article, "Understanding Spectrum design tokens", a technical/forward-looking companion to the S2 brand site's design-tokens page.

Related Issue

N/A — internal docs improvement, not tied to an open issue.

Motivation and Context

The public S2 design-tokens page is getting a concept-first refresh aimed at designers, and is deliberately light on where the token format is headed. The Spectrum Design Data site serves the technical audience (token consumers/authors/implementers) and had no home for narrative, point-in-time writing. This adds that home, using real, verified token names/values, and links forward into the published spec (/spec/) rather than duplicating it.

How Has This Been Tested?

  • Built the site locally (moon run site:copyContent && moon run site:build) and verified the Articles nav entry, index listing with category filter, and the article page render correctly with Spectrum table/link styling applied.
  • Verified every token name and value cited in the article against packages/tokens/src/*.json.
  • Confirmed docs/markdown/pages/articles/index.md is correctly generated by the markdown-generator.

Screenshots (if appropriate):

N/A

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)

Checklist:

  • I have signed the Adobe Open Source CLA.
  • My code follows the code style of this project.
  • My change requires a change to the documentation.
  • I have updated the documentation accordingly.
  • I have read the CONTRIBUTING document.
  • I have added tests to cover my changes.
  • All new and existing tests passed.

Adds a lightweight blog-style section to the docs/site 11ty site for
release notes, roadmap posts, and in-depth concept/decision write-ups,
with a first article covering the token format for a technical audience.

- docs/site/src/articles/: new post collection (directory data + layout)
- docs/site/src/pages/articles/index.md: category-filterable listing page
- docs/site/src/includes/layout/header.liquid, src/data/navigation.js: nav entry
- docs/site/eleventy.config.js: passthrough copy for article images
- docs/site/src/articles/understanding-spectrum-tokens.md: first post,
  a technical/forward-looking companion to the S2 "Design tokens" page,
  using verified real token names and linking into the published spec

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@changeset-bot

changeset-bot Bot commented Jul 10, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: d5d1ea8

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

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