Skip to content

Latest commit

 

History

History
24 lines (13 loc) · 1.7 KB

CONTRIBUTING.md

File metadata and controls

24 lines (13 loc) · 1.7 KB

Contribute to the HMRC Design System

Design your service using GOV.UK styles, components and patterns. If the thing you need is not there, you should use the HMRC Design System. If you still cannot meet the needs of your users proven by user research, then you can:

  • adapt an existing component or pattern
  • design a new component or pattern
  • suggest a new component or pattern

Styles should not be changed unless there is a good reason proven by user research. Work with GDS to agree any changes or improvements.

How to contribute

To suggest or share a new or adapted component or pattern, you should raise an issue on the HMRC Design Patterns repository. This is on Github, but it is easy to do. You must have a github.com account.

First, search and check if there is an issue for your component or pattern.

If there is an issue, add your findings.

If there is not, use the issue template to provide as much information as possible about the component or pattern.

When you contribute a component or pattern, explain how it meets the GOV.UK Design System criteria of being useful and unique and include any user research findings. You must do this before it can be included in the HMRC Design System.

A member of the HMRC Design System Working Group will respond to your issue.