← Back to Portfolio

Design System Documentation Portal

Transforming Design System Documentation: From Chaos to Clarity

Project Overview

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.

Project Details

ROLE
UX Researcher → Designer → Product Owner
CONTEXT
Global pharmaceutical company with 50+ brands, 100,000+ employees
RESEARCH SCOPE
30+ teammates across disciplines
CHALLENGE
Documentation outdated since 2018, tribal knowledge loss
IMPACT
Faster deployment, reduced support requests, improved consistency

The Challenge

Critical Scale Challenges

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.

Research & Discovery

Survey Research

Comprehensive assessment to 30+ teammates across disciplines using Microsoft Forms

User Interviews

1:1 moderated interviews with designers, developers, and design system users

Card Sort Analysis

Hybrid card sort to reveal user-preferred organizational models

Industry Research

Competitive analysis of documentation patterns from leading design systems

Critical Documentation Gaps Identified

Missing Component States

Component interaction states weren't documented anywhere

Impact: Designers had to inspect code and manually convert RGB values to hex to understand hover, focus, and disabled states
Solution: Complete visual state documentation for every component

No Anatomical Alignment

Designers and developers used different terminology for component elements

Impact: Confusion and misalignment during handoffs, with no shared vocabulary
Solution: Comprehensive anatomical labeling with numbered callouts

Structural Specifications Missing

Internal and external component structure wasn't documented

Impact: Designers had to reverse engineer or guess when customizing components
Solution: Responsive spacing documentation with precise measurements

Solution Strategy

Comprehensive Documentation Redesign

I redesigned the entire documentation approach to serve both audiences effectively while maintaining the system's integrity across pharmaceutical brands.

❌ Before: Legacy Portal Problems

Original design system portal showing dense, text-heavy documentation with poor visual hierarchy
  • Dense, text-heavy documentation
  • Poor visual hierarchy
  • Confusing navigation structure
  • No component visualization
  • Development-focused content
  • "Got time for some light reading?"

✅ After: Redesigned Portal

Redesigned design system portal with clean interface, visual component examples, and clear navigation
  • Clean, scannable interface
  • Visual component examples
  • Clear anatomical breakdowns
  • Multiple button states shown
  • Structured sections with tabs
  • Quick navigation sidebar

Specific Improvements Delivered

Content Guidelines Transformation

❌ Before

"Learn how [Brand] might be able to benefit you" - vague, confusing calls-to-action

✅ After

"Learn about [Brand]" with clear, specific action items and visual examples

Component State Documentation

❌ Before

Required manual code inspection, RGB to hex conversion, no documentation for interaction states

✅ After

Complete visual reference showing default, hover, active, focus, and disabled states for every component

Information Architecture Overhaul

❌ Before

Dense, paragraph-heavy documentation with poor scanability

✅ After

Structured content with clear section anchors, quick navigation, and visual hierarchy

Results & Business Impact

🚀
Faster Deployment
Accelerated marketing websites across pharmaceutical brands
📞
Reduced Support
Significant decrease in support requests from design teams
👥
Positive Reception
Well-received by both designers and developers
📊
Built-in Analytics
Design system usage tracking and adoption insights

Enterprise-Scale Impact

Role Evolution Through Project

Research Phase

Led comprehensive user research including surveys, interviews, card sorts, and heuristic analysis to identify critical documentation gaps

Design & Product Phase

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.

Challenges & Solutions

Balancing Multi-Brand Requirements

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

Bridging Design-Development Gap

Challenge: Two audiences with different information needs and technical vocabularies

Solution: Parallel documentation paths with shared anatomical specifications that served both perspectives

Stakeholder Alignment During Role Transitions

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

Post-Launch Strategy & Sustainability

Continuous Improvement Framework

Skills Demonstrated

UX Research
Information Architecture
Design Systems
Product Management
Content Strategy
Stakeholder Management
User Interviews
Card Sort Analysis
Heuristic Analysis
Enterprise UX
Cross-functional Collaboration
Change Management
Accessibility
Technical Writing
International Design
Component Documentation

View More Case Studies