You can contribute content in different ways to HDS. Before you start contributing to HDS, please refer to following guidelines.
Every component in HDS includes three parts:
You may contribute in any part of these but all three parts have to be implemented and validated by HDS team before a feature can be released.
The easiest way to start contributing to HDS is joining the City of Helsinki Slack channel (#designsystem) and send us a message.
Depending on the feature you want to be working on, you will need access to at least some of these tools:
- City of Helsinki organisation in Abstract
- City of Helsinki Slack (channel: #designsystem)
- HDS GitHub repository
When faced with a need for a component or feature, you can ask yourself a few simple quiestions to decide whether you should propose a new component or feature to be added in HDS, or desing a custom a implementation:
Before you start working or proposing a new component, it is important to check whether it already exists in HDS or in our roadmap.
- Check if it exists in HDS components.
- Check if it exists on HDS roadmap.
- Check if someone else has already proposed it in GitHub issues.
Go through the list of existing HDS components. See if some of the components could be slightly altered to suit your needs while still fulfilling existing requirements. If yes, move on to making a proposal for the change.
Think outside of the scope of your project. Can this component be utilized in other projects as well? If not, could you make it something more generic to match needs of other projects? Discuss with other projects and community.