Skip to content

Conversation

@caseyisonit
Copy link
Contributor

@caseyisonit caseyisonit commented Dec 2, 2025

@nikkimk, @KBmyer and I are taking a stab at bringing our 2nd-gen docs and IA to the future

* chore: two ways of working with markdown files for guides

* chore: cursor rule for migrating markdown to mdx if needed

* chore: stubbed docs and ordered them

* chore: lint fix
@changeset-bot
Copy link

changeset-bot bot commented Dec 2, 2025

⚠️ No Changeset found

Latest commit: 0fab704

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

@github-actions
Copy link
Contributor

github-actions bot commented Dec 2, 2025

📚 Branch Preview Links

🔍 First Generation Visual Regression Test Results

When a visual regression test fails (or has previously failed while working on this branch), its results can be found in the following URLs:

Deployed to Azure Blob Storage: pr-5916

If the changes are expected, update the current_golden_images_cache hash in the circleci config to accept the new images. Instructions are included in that file.
If the changes are unexpected, you can investigate the cause of the differences and update the code accordingly.

nikkimk and others added 3 commits December 4, 2025 19:14
* docs(a11y): added a11y guides to storybook

* docs(a11y): fixed typo
* chore: two doc blocks to get custom docs added to the template

* chore: clean upa few things

* chore: usage stories and descriptions for custom doc blocks

* chore: streamlining tags in stories and created capitalize utility

* chore: review fixes

* chore: updated tags in stories to new pattern
* docs(progress-circle): updated and formatted progress circle dpcs

* docs(divider): updated and formatted divider stories

* docs(divider): added size args to stories

* docs(status-ligt): updated status-light docs and stories

* docs(progress-circle): added progress arg type for docs and stories

* docs(divider): added description to stories and docs

* docs(badge): added description to stories and docs

* docs(status-light): made correction to docs

* docs(status-light): made correction to docs

* docs(badge): updated badge docs and stories

* docs: fixed typos

* docs: removed the 'usage' tag from stories

* docs(assets): updates asset docs and stories
@caseyisonit caseyisonit added the do-not-merge NO MERGE-Y! label Dec 8, 2025
nikkimk and others added 6 commits December 9, 2025 08:48
* docs(contributor-guides): mrigrated contributor guides

* docs(contributor-docs): updated contributor docs to reflect storybook migration

* docs(contributor-guides): updated based on new IA and use of storybook

* docs(contributor-guides): fixed MDX errors

* docs(contributor-guides): fixed TOC

* docs(contributor-guides): fixed typo

* docs(contributor-guides): fixed TOC

* docs(project-planning): migrated project-planning docs to storybook

* docs(project-planning): fixed typo

* docs(guides): fixed links
* chore: two doc blocks to get custom docs added to the template

* chore: clean upa few things

* chore: usage stories and descriptions for custom doc blocks

* chore: streamlining tags in stories and created capitalize utility

* chore: review fixes

* chore: updated tags in stories to new pattern

* chore: styling sturf and starting decorators

* chore: all kinds of improvements

* chore: working on static primary story but got smart links working

* chore: clean up format and doc blocks

* chore: migrated all 2nd gen to new format, made rules, working on styles

* chore: removed tag from testing

* chore: remove console logs

* docs: updates rules for stories to include sections in the prescribed order

* docs: updated rules to remove "demo" class recommendations for headings

* docs: update exclusions for TOC headings in previews

* docs: added rule to require that all stories are accessible

* docs: status-light updates stories based on revised rules

* docs: added additional styling parameters to flex layout decorator

* docs: updated preview for better source code in docs

* docs(status-light): updated status light based on new rules

* docs(badge): updated docs according to updated rules

* docs: updated flex-layout decorator for addtional styling options

* docs: added a static colors decorator that displays both satic colors as a single story

* docs: added a static colors decorator that displays both satic colors as a single story

* docs: update rules to include static colors decorator

* docs(divider): updated divider based on updated rules

* docs: added a simple static colors exmaple to rules

* docs(progress-circle): updated progress circle docs according to updated rules

* docs(divider): simplified static colors story for divder and updated rules

---------

Co-authored-by: Casey Eickhoff <ceickhoff@adobe.com>
* docs: updated flex-layout decorator to opt-in

* docs: updating stories

* docs: updated stories and section order

* docs: updated rules

* docs: updated contributor docs for migrating stories

* docs: updated documentation

* docs: updated documentation

* Merge branch 'garage-week/docs-rocks' of github.com:adobe/spectrum-web-components into nikkimk/docs-rocks-refinements

* docs: updated docs and rules to include picsum photos

* docs: removed static-color-wrapper helper

* docs: fixed sorting of getting started docs
* docs: updated about SWC with Kari's edits

* docs: renamed get-started to about-swc

* docs: fixed table import

* docs: added documentation styl guide to style guides
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants