Skip to main content
Release

Release

Releases are how new tokens and patterns reach teams. A release process makes sure updates are clear, consistent, and trusted. Each release should follow the way you have defined for your system, scaling from a light touch to a full walkthrough or workshop depending on impact. Use this when rolling out new work or updating existing patterns.

How to

  1. Plan the release

    Define what is changing, who is impacted, and whether it is a patch, minor, or major update. Choose if it should be piloted or pushed system-wide.

  2. Choose the right channel

    Match communication to the size of the update. Small changes may only need a light message update in your Systems channel, larger ones may need a changelog, walkthrough, or workshop.

  3. Communicate clearly

    Explain what changed, why it matters, and whether migration is needed.

  4. Support migration and retirement

    Reference Migration Guides to give teams a clear path from old to new, and link to Retire and Replace where older work is being phased out.

  5. Update guidance

    Make sure your Guidance Setup reflects the new release though updating or Create a Guidance Page.

  6. Collect feedback

    Capture issues and questions to improve both releases and your framework.