Contributing

#Before you start

If you intend to build a new component, change a public API, make design improvements, or any other non-trivial changes, we recommend getting in touch with us in #ux_fancy to clear UX patterns and ensure visions are aligned. This lets us all discuss and reach an agreement on the proposal before you put in significant time and effort.

#Establish shared value

The first step of any contribution — design, code, or documentation — is establishing the shared value for the proposed feature or enhancement. To ensure the design system provides the highest shared value, contributions to Fancy should be relevant to two or more product teams.

Identifying other products or use cases that may benefit from your proposed contribution not only helps define requirements, but also establishes key partners to collaborate with.

#What to do if you're unable to establish shared value

If you're unable to establish shared value for your contribution across two or more products, consider how to use existing Fancy components and patterns to build the feature you need within your own product.

If you feel that your contribution still makes sense, you can always start a conversation with the Fancy team in #ux_fancy or #dev_fancy or find us at our office on the development floor west wing during regular opening hours.

In order to keep our design system and processes light and flexible, communication on desired changes and visions is important, since the Design System impacts all teams and parts of the product. We want to ensure a coherent and awesome user experience across all products and development teams.

#When should you talk with Fancy?

While Product Designers at Siteimprove are expected to partner with the Fancy team for their work, we recommend that all POs and engineers engage with us early, and often! Either by writing in #ux_fancy or #dev_fancy or directly to Fancy team members. We offer a collaborative space in which to incubate your ideas. Here are some checkpoints that are great times to reach out to our team:

#As a Product Designer

• After your first week at Siteimprove. Come say hi in #ux_fancy or #dev_fancy or find our office at the development floor west wing.
• At the start of a project / early wireframe mockups. Reach out to us with heads up on projects, deadlines for delivery, and any components or compositions that you're confident will be necessary.
• At the start of medium or high fidelity design. This is a great time to share your specific needs with the Fancy team. You may also begin to receive feedback on accessibility or pattern usage at this stage.
• Before user testing, UX reviews or launch. Before you share your ideas with customers or get a sign off on the final design, drop by for a deep dive on copy, component and composition usage, accessibility, final polish and other design considerations.

#As a Developer

• After completing your Siteimprove onboarding. Come say hi in #ux_fancy or #dev_fancy or find our office at the development floor west wing.
• When making (breaking) changes to Fancy. Before making (breaking) changes to Fancy Lab or Lib, we recommend you reach out to us. This enables us to collaborate with you on your proposal and discuss important points, before you put in significant time and effort. This early feedback loop is especially helpful when proposing breaking changes, since that requires filling out a breaking change template.
• When encountering design specifications that Fancy components don't support. This will often be an indicator that there is misalignment within the UX team on what cases a component or pattern should be used for. In other cases, the restriction is unintended and we can discuss the best course of action for resolving the issue. In either case, it's great feedback for the Fancy team and valuable input for future component requirements.

#What kind of support can you expect from the Fancy team?

We're excited to partner with you on building better products. Towards this, you can expect the following levels of support from the team:

• Request components or patterns that you may need for your customer experiences.
• Get feedback on the usage of components and compositions in your mocks and/or UIs.
• Get information about building more accessible UIs, and any common pitfalls that one might typically encounter.
• Get support on hierarchy, weight, and spacing in your UIs.
• Get answers to clarifying questions about Design Systems concepts.
• Verify if your UIs are aligned with the content, UX, and accessibility guidelines.
• Get constructive feedback that helps your UI follow the design system and accessibility conventions that are expected in Siteimprove.

It's important to note that the Design Systems team does not directly talk to customers, and is not a replacement for research and customer understanding. While we're happy to provide feedback on the product decisions made, we recommend testing with customers or customer proxies to better understand if we're solving for their needs.