Suggest a removal
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.
How the Design System Team deprecates a component
When we decide to remove a component, we take the following steps:
- In the codebase, move the component’s CSS into a
deprecating.scssfile (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.
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.