[CMSDS-4040] Add For Designers page to Doc Site#4079
Open
jack-ryan-nava-pbc wants to merge 3 commits into
Open
[CMSDS-4040] Add For Designers page to Doc Site#4079jack-ryan-nava-pbc wants to merge 3 commits into
jack-ryan-nava-pbc wants to merge 3 commits into
Conversation
jack-ryan-nava-pbc
requested review from
carolyn-crabbycrab,
derek-cmsds,
sophia-cmsds and
tamara-corbalt
jack-ryan-nava-pbc
added
Impacts: Documentation
|
|
||
| CMS sets clear expectations for how to use the Design System. Designers **should follow Design System guidance and use its components and patterns** as defined. | ||
|
|
||
| If a requirement can't be met using the Design System, document the gap and consider [submitting a contribution proposal](/getting-started/contribution-guidance/) with the Design System team before introducing custom solutions. |
Collaborator
Author
There was a problem hiding this comment.
Note that the link here deviates from what is in the PDF. I assume that when the PDF was written, we didn't have a Contribution Guidance page?
|
|
||
| A [pattern](/patterns/overview/) is a combination of components used together to solve a common user interaction. Examples include form review or utility actions. Patterns are available in both the CMS Design System documentation and Figma. | ||
|
|
||
| CMS expects teams to use Design System patterns as outlined. If a pattern doesn't meet your needs, adapt it only if it remains consistent with the Design System's visual language and accessibility guidelines. If you have significant changes from what's outlined in the Design System, document the use case and consider [submitting a contribution proposal](/getting-started/contribution-guidance/). |
Collaborator
Author
There was a problem hiding this comment.
Same thing here. Pointing to internal contribution guidance.
derek-cmsds
requested changes
May 29, 2026
Collaborator
derek-cmsds
left a comment
derek-cmsds
left a comment
There was a problem hiding this comment.
Some incorrect links and a question about icons.
| - **[Core](https://design.cms.gov/?theme=core)**: The foundation for the entire Design System. Rarely used by CMS project teams as their default theme. | ||
| - **[Healthcare.gov (theme)](https://design.cms.gov/?theme=healthcare)**: For all teams working on [Healthcare.gov](https://healthcare.gov) | ||
| - **[Medicare.gov (theme)](https://design.cms.gov/?theme=medicare)**: For all teams working on [Medicare.gov](https://medicare.gov) | ||
| - **[CMS.gov (theme)](https://design.cms.gov/?theme=cms)**: For all teams working on [CMS.gov](https://cms.gov) |
Collaborator
There was a problem hiding this comment.
This link is incorrect. It should be https://design.cms.gov/?theme=cmsgov
|
|
||
| ### Components | ||
|
|
||
| A [component](/components/) is a reusable UI element with a defined function and behavior. These are the building blocks of the Design System. Examples include buttons, checkboxes, and text inputs. Some components have specific usage guidelines that should be followed. |
Collaborator
There was a problem hiding this comment.
I believe you meant to link to this URL: http://localhost:8000/components/overview/
|
|
||
| The CMS Design System uses [Figma](https://www.figma.com/design/OYkYP4pC9jwS7j2qafwmiv/Design-System-Library?m=auto&node-id=718-40190&t=rRYhkftLTZ2TvytT-1) to maintain its visual library. | ||
|
|
||
| <Alert hideIcon={true} variation="warn"> |
Collaborator
There was a problem hiding this comment.
Why are we hiding icons? We show them in the For Developers page: https://design.cms.gov/getting-started/for-developers/
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
2 participants
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
How to test
Checklist
[CMSDS-####] Titleor [NO-TICKET] if this is unticketed work.Type(only one) label for this PR, if it is a breaking change, label should only beType: BreakingImpacts, multiple can be selected.