GitHub

Design system annotations, part 2: Advanced methods of annotating components

May 9, 2025Jan Maarten
Design system annotations, part 2: Advanced methods of annotating components
SummaryAI, from the source post

This post details advanced methods for creating 'Preset annotations' for design system components. It outlines a process for prioritizing components that would benefit most from these annotations, using internal tools like Primer Query and criteria such as alignment to organization priorities, frequency in audit issues, React implementation, and implementation frequency. The post also details how to map out necessary properties by cross-referencing component documentation on Primer.style, coded demos in Storybook, and component properties in Figma assets, as well as other potential sources like team experiences and audit findings. It provides a concrete example with the TextInput component, detailing its Preset annotation and learnings about maintenance and potential automation. It also addresses the confusion arising from overlap with other annotation types and suggests solutions.

More from the Design System Annotations trail