Contents
I will be presenting a practical session on creating well-documented design systems and how AI can support this process responsibly. The talk explores why documentation is critical for design system adoption, what “good documentation” actually includes, and how designers can structure guidance that reduces ambiguity and speeds up decision-making.
I will also demonstrate concrete ways AI can assist in drafting, reviewing, and scaling documentation — while highlighting the limitations and risks that require human oversight. The goal is to provide attendees with actionable workflows they can immediately apply within their own teams.
Takeaways
1) A design system without documentation is just a component library.
2) Good documentation reduces cognitive load.
3) Documentation is a design problem.
4) The real goal is adoption.
more...
Prior knowledge
Participants should have prior experience working with design systems, either as contributors or active users. Familiarity with component libraries, usage guidelines, and system documentation will help attendees fully engage in the workshop discussions and exercises.
The session is designed for designers who have encountered real-world challenges with adoption, documentation gaps, or scaling systems, as this allows us to explore deeper and more practical scenarios.