Contributing
Arc is always looking to expand to better meet our users’ needs. This can happen through progressive thinkers like you and your team members.
Types of Contributions
Existing WinNG component request
A feature request to add onto an existing component that could enhance functionality.
New WinNG component request
A new component contribution that will improve design and/or user experience for all teams.
Bug fix
See an issue with design, code, or documentation? Please let us know as soon as possible. When reporting, we request you explain the issue and severity with as much detail as possible to help us with prioritization.
Arc Documentation update
If your application has an update, we would love to document it! When other users visit Arc, it can showcase the most recent version, and inspiration can be gathered. This results in greater consistency.
How to Contribute
The contribution process will look different between design and development. Depending on the type of contribution you choose, you will be directed to the appropriate resource and/or team.
- WinNG: Platform Development team
- PrimeNG: PrimeTek (third party)
- Arc: Architecture team
Design
1. Email the Design Panel (designpanel@winsupply.com).
2. Title the subject with one of the following contribution types: Existing Component Request, New WinNG Component Request, Bug Fix, or Arc Documentation Update. Please provide as much detail as possible, along with screenshots or links to your concept.
3. The WISE Experience Designer will create a story on the UIUX - WISE Design System (Arc) Jira board and present the contribution to the UI/UX Panel. If your contribution is only a documentation update, the WISE Experience Designer will update Arc to reflect the appropriate changes.
4. If approved, the Design Panel will set up a meeting with you and the Platform Development Manager to discuss a plan for completing the design and implementation.
Development
New WinNG Component Request: Create a story on the WC Jira board
PrimeNG issue: Submit an Issue to Primefaces
Arc Documentation Update: Email the Design Panel
Core Principles
Consistency
It is important that your component matches Prime/WinNG theming. This will ensure a consistent experience across WISE applications.
Flexibility
Your design can work with multiple use cases. Multiple teams and applications may benefit from your contribution.
Forward-Compatibility
Make your component reusable by considering how future functionalities and/or capabilities can be added for easier maintenance.
Accessibility
This is a top priority to ensure all users can successfully interact with our applications. All components and icons must meet WCAG 2.1 AA standards (AAA is preferred but not required).
Check Before Contributing
Prime or WinNG may currently have a solution. When in doubt, feel free to reach out to the Platform Development team or WISE Experience Designer if you need help searching either library or coming up with creative solutions.
Contributors
- UI/UX Designers
- Front-End Developers
- POs
- Directors
- Executives
If you do not fall within one of these categories, you are still encouraged to contribute. Arc is open for all Winsupply employees who would like to donate their ideas on how we can improve components and/or icons, which leads to improving overall WISE design and experience.
Contact Us
Any questions about components, bug fixes, documentation, or the contribution process are welcome. Once you fill out the form below, your submission will be sent to the Platform Development team or the Design Panel, and it will be addressed as soon as possible.
