4.2 Release.

Release

1 hour - 1 day

What is it?

An announcement on the readiness of the component and how to use it.

Why do we do it?

Communicate updates to the system so that teams are aware of changes and how to use them.

How do we do it?

Small changes

For a minor change to a component or a little update to the system.

  • A post on Slack with a visual to explain the change.
  • Depending on its minor, you might not need to share any updates.

Medium changes

A new component or noticeable changes to an existing component that people need to know about.

  • A longer post on Slack with a recorded demo of the update.

Large changes

For larger changes like a breaking change or a big feature

For more significant changes like a breaking change or an important feature.

For significant updates, ensuring people get as many opportunities as possible to see and understand what they must do is essential.

  • Slack post outlining the changes, as well as a video walkthrough and a demo
    • Shared on your Design System channel and forwarded to all guild channels
  • A live demo or presentation of the update at all relevant guild and design meetings; ideally, you would pair with a Developer in the relevant guild sessions.
  • You may also consider doing a workshop to teach people how to use or action the proposed changes.

What to include

Regardless of the size of the change, be sure to include the difference and why it was done. Be sure to include —

Visual examples

An animated gif or short video demo of the component in action.

Platform availability

Depending on how many platforms you support, you may end up staggering releases between them. It’s important to highlight when the expected date for each of these releases is.

  • Build documentation
  • Usage documentation
  • Figma component

Outcomes

  • Teams know about and how to use the component.
  • Greater visibility of the system
  • Higher adoption of your components

Hot tips

Include justification for the change as part of your release, even if it’s brief. This ensures everyone is on the same page as you and mitigates the risk of heavy pushback on the component.

Be ready for feedback at this stage, and be open to it — if no one wants to use your component in the way it is, it’s essential to understand why. If you’ve included ample justification, and people are still pushing back, listen.