Transforming Design System Documentation: From Chaos to Clarity
The design system faced a perfect storm of challenges following the merger of disparate UX/Design groups into one Enterprise UX organization. Documentation hadn't been updated since 2018, creating a massive knowledge gap serving 100,000+ employees across 50+ pharmaceutical brands.
Through comprehensive research and systematic redesign, I transformed outdated, development-focused documentation into a user-centered system that accelerated deployment cycles and reduced support requests.
The Perfect Storm: Documentation from 2018, development-focused portal alienating designers, tribal knowledge being lost as team members left, and enterprise-scale complexity across pharmaceutical brands.
Comprehensive assessment to 30+ teammates across disciplines using Microsoft Forms
1:1 moderated interviews with designers, developers, and design system users
Hybrid card sort to reveal user-preferred organizational models
Competitive analysis of documentation patterns from leading design systems
Component interaction states weren't documented anywhere
Designers and developers used different terminology for component elements
Internal and external component structure wasn't documented
I redesigned the entire documentation approach to serve both audiences effectively while maintaining the system's integrity across pharmaceutical brands.
"Learn how [Brand] might be able to benefit you" - vague, confusing calls-to-action
"Learn about [Brand]" with clear, specific action items and visual examples
Required manual code inspection, RGB to hex conversion, no documentation for interaction states
Complete visual reference showing default, hover, active, focus, and disabled states for every component
Dense, paragraph-heavy documentation with poor scanability
Structured content with clear section anchors, quick navigation, and visual hierarchy
Led comprehensive user research including surveys, interviews, card sorts, and heuristic analysis to identify critical documentation gaps
Transitioned to product owner during maternity leave, managing backlog and stakeholder alignment while continuing design work
This role evolution demonstrated adaptability and growth from researcher to strategic leader, managing both the tactical execution and the broader product strategy simultaneously.
Challenge: Serving dozens of pharmaceutical brands with different visual needs while maintaining system consistency
Solution: Created flexible documentation framework that showed brand variations within consistent structural patterns
Challenge: Two audiences with different information needs and technical vocabularies
Solution: Parallel documentation paths with shared anatomical specifications that served both perspectives
Challenge: Maintaining project momentum while transitioning between research, design, and product owner responsibilities
Solution: Clear documentation and communication protocols that enabled smooth handoffs and continued progress