Online / 5 & 6 February 2022


Documenting a Design System

Lessons learned from open sourcing the Orbit docs

A design system helps contributors create consistent user experiences. To elevate from a collection of patterns to a system, you need to provide clear standards and reasoning. Clear and comprehensive documentation helps you put this system together into something everyone can use.

This talk will go through how we open sourced the documentation for the Orbit design system and discuss what we learned from the process. It will discuss creating both visual and content standards for the docs and how it was all accomplished. The lessons from this experience can help in the creation of useful and accessible documentation to guide the design process.


Photo of Aaron Collier Aaron Collier