Docs: 11ty site, markdown generator, remove spectrum-glossary#696
Merged
Docs: 11ty site, markdown generator, remove spectrum-glossary#696
Conversation
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
…site Co-authored-by: Cursor <cursoragent@cursor.com>
…anch Co-authored-by: Cursor <cursoragent@cursor.com>
…ry step Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
- 11ty: setUseGitIgnore(false) so generated .md are processed - 11ty: use src/ prefix in collection globs (relative to project root) - Fix frontmatter delimiters (---) on all page templates for permalinks - viewer: replace shell prepare with Node script to avoid mkdir failure under moon - Remove spectrum-glossary from .moon/workspace.yml Co-authored-by: Cursor <cursoragent@cursor.com>
…docs/site/src Co-authored-by: Cursor <cursoragent@cursor.com>
|
Member
Author
Run report for 016ddc31Total time: 1m 16s | Comparison time: 3m 5s | Estimated savings: 1m 49s (58.8% faster)
Expanded report
Touched files |
GarthDB
added a commit
that referenced
this pull request
Feb 12, 2026
Add GitHub Actions workflow to publish docs/s2-docs markdown files to a docs-markdown orphan branch for chatbot indexing. This is Phase 1 of publishing markdown content - Phase 2 will add markdown-generator output alongside s2-docs content in PR #696.
GarthDB
added a commit
that referenced
this pull request
Feb 12, 2026
…#701) * fix(s2-docs): fix YAML frontmatter syntax errors and improve validation - Add js-yaml dependency to actually parse YAML and catch syntax errors - Fix improperly indented field names (related_components, parent_category) - Fix escaped underscores in field names - Update validation to catch YAML parsing errors before other checks - Fixed 86 markdown files with YAML frontmatter issues * feat(docs): add workflow to publish s2-docs markdown to orphan branch Add GitHub Actions workflow to publish docs/s2-docs markdown files to a docs-markdown orphan branch for chatbot indexing. This is Phase 1 of publishing markdown content - Phase 2 will add markdown-generator output alongside s2-docs content in PR #696.
Add documentation for the 11ty site and markdown generator, AVA test configuration, and tests covering components, tokens, registry, and token-resolver modules. Co-authored-by: Cursor <cursoragent@cursor.com>
- Output markdown to docs/markdown/ (committed) instead of orphan branch - Add README in docs/markdown/ stating files are generated - Update markdown-generator to write to docs/markdown, add Moon deps - Update site copy-content to read from docs/markdown - Remove publish-markdown.yml workflow - Clear markdown-generator .gitignore (no local output dir) - Skip docs/markdown/ in lint-staged (generated files) Co-authored-by: Cursor <cursoragent@cursor.com>
- Add PostCSS with postcss-import to resolve @spectrum-css imports - Add build:css script to compile CSS before Eleventy - Import full component CSS (index.css) for page and sidenav - Remove manual pathPrefix from layout and pages (HtmlBasePlugin adds it) - Output built CSS to site.css (gitignored) - Fixes stylesheet 404 and unstyled site in local dev Co-authored-by: Cursor <cursoragent@cursor.com>
Path should be ../markdown from docs/site, not ../../markdown Co-authored-by: Cursor <cursoragent@cursor.com>
The {% for %} loop over navigation.top was rendering hundreds of times
instead of once, causing massive navigation duplication. Hard-coding the
8 navigation links works correctly. This appears to be an Eleventy/Liquid
template processing bug with global data iteration.
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
GarthDB
force-pushed
the
spectrum-design-data-docs
branch
from
efedcd0 to
016ddc3
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Implements the docs rebuild plan:
Markdown generator (
tools/markdown-generator/): Converts tokens, component-schemas, and design-system-registry into markdown with frontmatter. Outputs tooutput/components/,output/tokens/,output/registry/. Token docs include named anchors, alias linking, resolved values, deprecation, and "Replaced by" links for renamed tokens.11ty site (replaces Next.js in
docs/site/): Scaffolded from adobe/11ty-starter. Custom layouts for component, token-group, and registry pages. Collections and navigation for Components, Tokens, Registry, Tools. Build pipeline:markdown-generator:generate→site:copyContent→site:build→site:export.Orphan branch
docs-markdown: New workflow.github/workflows/publish-markdown.ymlpublishes generated markdown todocs-markdownfor chatbot/indexing. Triggers on push to main, after Release, or workflow_dispatch.Remove spectrum-glossary: Deleted
docs/spectrum-glossary/. Registry/glossary content now served from 11ty under/registry/.Deploy workflow: Updated
.github/workflows/deploy-docs.yml— clean site dir, run markdown-generator, then site:export (11ty); removed spectrum-glossary:export. Other apps (visualizer, s2-visualizer, viewer, release-timeline) unchanged.Token validation: New AVA tests in
packages/tokens/test/:checkRenamed.test.js(renamed values must reference existing tokens),checkAliasReferences.test.js(alias refs{token-name}must resolve to existing tokens).Viewer prepare: Replaced shell
mkdir/cpindocs/s2-tokens-viewerwith Node scriptscripts/prepare.mjsto avoid failures under moon.11ty fixes:
setUseGitIgnore(false)so generated .md in components/tokens/registry are processed; collection globs usesrc/prefix; YAML frontmatter (---) on page templates; lint-staged skipsdocs/site/src/for remark;copy-content.jscreates destination dirs withmkdirSync;copyContenttask usesplatform: node.Made with Cursor