Skip to content

Commit

Permalink
Merge branch 'main' into updated-hub-guidance
Browse files Browse the repository at this point in the history
  • Loading branch information
humancompanion-usds authored Dec 3, 2024
2 parents 9ceddf5 + cc648bc commit 2cf6d30
Showing 1 changed file with 2 additions and 1 deletion.
3 changes: 2 additions & 1 deletion src/_components/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,12 +42,13 @@ All teams must now be using the v3 versions of our web-components. The Design Sy
</div>
</va-alert>

### Governance rules for using v3-based components
### Governance rules for using components

v3-based versions of the components are designed to sit alongside our current v1 based components and the foundational elements of the Design System. Teams must use the new versions of our web-components and following these rules:

* Do not mix and match different versions (v1 vs. v3) of the same component on the same page. For example, if you were to use the v3-based version of the [accordion component]({{ site.baseurl }}/components/accordion) on a page, that version must be used throughout that page (and ideally throughout your application as soon as possible).
* Do not mix and match v1 and v3 based [form components]({{ site.baseurl }}/components/form/) in the same application flow. For example, if you were to use the v3-based version of the radio button component on the first step in an application, that version must be used on all subsequent steps throughout the flow.
* Most examples of design system components can be found in Storybook. If your team is using any component outside of the design system web components, that is considered an imposter component and will be listed as a violation at your Staging Review. This includes components that are coded to look and function like design system web components, but do not use the design system code.

{% include components-patterns-templates.md %}

Expand Down

0 comments on commit 2cf6d30

Please sign in to comment.