Skip to main content
U.S. flag

An official website of the United States government

Dot gov

The .gov means it’s official.
Federal government websites often end in .gov or .mil. Before sharing sensitive information, make sure you’re on a federal government site.

Https

The site is secure.
The https:// ensures that you are connecting to the official website and that any information you provide is encrypted and transmitted securely.

August updates! We reorganized our patterns in August.

About

Suggest a removal

Follow the steps below to suggest a component or pattern be deprecated in the design system

Like any site on the web, we can expect VA.gov’s design to evolve. Some components might be updated and improved, while we might remove others entirely in favor of a replacement.

Deprecating a component is done only by the Design System Team. However, you can file an issue requesting that a component or pattern be deprecated. Be sure to include the following in your request:

  • Justification for removing the component or pattern
  • A recommendation on a replacement

You may need to come to the Design System Council with your request for discussion.

Suggest a removal

How the Design System Team deprecates a component

When we decide to remove a component, we take the following steps:

Deprecation

  • In the codebase, move the component’s CSS into a deprecating.scss file (empty placeholder file still needs to be added to Formation)
  • Update the component-library version number to the next MINOR version.
  • On the component’s guidance page in design.va.gov mark the component as deprecated.
  • Add a note on the “What’s new?” page indicating that the component is deprecated under the heading of the component-library version number mentioned above.
  • Archive the component in the Sketch pattern library and remove any symbols.

Removal

After a 30 day period the component can be removed entirely. To remove the component:

  • Delete the corresponding CSS selectors
  • Since this is a breaking change, update the component-library to the next MAJOR version
  • Remove the guidance page from design.va.gov
  • Add a note on the “What’s new?” page about the removal under the heading of the Formation version number mentioned above.
Edit this page in GitHub (Permissions required)
Last updated: Jun 29, 2022