← Documentation
VERSIONING

Make change legible

Use Major.Minor.Patch language for Design Studio decisions and documentation updates.

Version levels

  • Major · incompatible component API or token structure change
  • Minor · compatible component, pattern, template, theme, or feature addition
  • Patch · bug fix, accessibility improvement, documentation correction, or visual refinement

Lifecycle

  • Draft
  • In Review
  • Ready
  • Deprecated
  • Removed

Deprecated items should retain migration guidance until a replacement is available.

Release notes structure

  • Version and date
  • Added, changed, fixed
  • Deprecated and removed
  • Accessibility
  • Migration notes
  • Known issues