Designing Experience
Documentation at Scale

Designing Experience
Documentation at Scale

As the design team scaled, inconsistent documentation slowed reviews, increased risk, and made collaboration harder than it needed to be.

As the design team scaled, inconsistent documentation slowed reviews, increased risk, and made collaboration harder than it needed to be.

I designed a shared UI documentation toolkit in Figma to bring structure, clarity, and accountability to design work supporting multi-stage reviews, cross-functional alignment, and regulated delivery at scale.

I designed a shared UI documentation toolkit in Figma to bring structure, clarity, and accountability to design work — supporting multi-stage reviews, cross-functional alignment, and regulated delivery at scale.

A standardized abstraction of a documentation layout with annotations, approvals, role-specific notes and review readiness at a glance.

The Problem

The Problem

Existing documentation didn't support:

Multi-stage design reviews and approvals

Multi-stage design reviews and approvals

Clear separation between research, design, and development context

Clear separation between research, design, and development context

Traceability across business requirements, research findings, and final UI

Traceability across business requirements, research findings, and final UI

Fast, reliable review across design, product, and engineering

Fast, reliable review across design, product, and engineering

My Role

My Role

Abstracted complex data hierarchies into clear, step-by-step flows

Abstracted complex data hierarchies into clear, step-by-step flows

Owned the design end to end

Owned the design end to end

Defined structure, components, and documentation standards

Defined structure, components, and documentation standards

Drove adoption across teams

Drove adoption across teams

Iterated based on real feedback

Iterated based on real feedback

Scope

Scope

Standardized Figma file structure for design documentation

Standardized Figma file structure for design documentation

Created components for annotations, status tracking, approvals, and role-specific notes

Created components for annotations, status tracking, approvals, and role-specific notes

Built documentation structure of key requirements and supporting resources

Built documentation structure of key requirements and supporting resources

Shared and maintained as a living system

Shared and maintained as a living system

Governance

Multi-stage review & approval

Governance

Multi-stage review & approval

Governance

Multi-stage review & approval

Traceability

From requirements to UI

Traceability

From requirements to UI

Traceability

From requirements to UI

Reviewability

Fast, reliable feedback loops

Reviewability

Fast, reliable feedback loops

Reviewability

Fast, reliable feedback loops

Launched

Designed for Review

Built for critique and collaboration across the Business, Product, and Enginneering

Launched

Designed for Review

Built for critique and collaboration across the Business, Product, and Enginneering

Launched

Designed for Review

Built for critique and collaboration across the Business, Product, and Enginneering

Early indicators positive

Consistency Over Individual Customization

Shared standards over personal patterns

Early indicators positive

Consistency Over Individual Customization

Shared standards over personal patterns

Early indicators positive

Consistency Over Individual Customization

Shared standards over personal patterns

Early indicators positive

Clarity at a Glance

Key information surfaced immediately

Early indicators positive

Clarity at a Glance

Key information surfaced immediately

Early indicators positive

Clarity at a Glance

Key information surfaced immediately

1. File Structure & Layout

1. File Structure & Layout

A standardized layout designed to make review context and documentation status immediately clear.

This structure highlights screen headers, status indicators, annotations, and supporting resources.

2. Annotation System

2. Annotation System

The color coded annotation system standardized the way important information was conveyed for our designs.

Annotations were structured, role-aware, and visually distinct, making it easy to understand why a design decision was made — not just what was designed.

3. Status and Approval Tracking

Because all customer-facing designs required multi-stage approval, the toolkit included clear status and approval indicators at the screen and flow level.

Supported governance without adding more processes

Reduced missed or duplicated reviews

Increased confidence for handoff

This made review readiness visible at a glance and reduced confusion around what had been reviewed, approved, or was still in progress.

4. Role-Specific Notes

Design documentation needed to work for different audiences simultaneously — designers, product partners, stakeholders, and developers. This allowed:

Reviewers to focus on what mattered to them

Reduced noise while preserving important context

Clearer cross-functional collaboration

I introduced role-specific note patterns to separate research insights, design rationale, and development considerations without fragmenting the file.

5. Supporting Resources and Traceability

To improve traceability, the toolkit included structured ways to reference supporting materials like research artifacts, process flows, business requirements, and stakeholder inputs.

Additionally, it lists team members and links to their related work items (Azure DevOps in this example).

Clear documentation is infrastructure.

This toolkit turned fragmented design files into a shared, review-ready system that scaled with team size, governance needs, and real-world constraints.

Clear documentation is infrastructure.

This toolkit turned fragmented design files into a shared, review-ready system that scaled with team size, governance needs, and real-world constraints.

Clear documentation is infrastructure.

This toolkit turned fragmented design files into a shared, review-ready system that scaled with team size, governance needs, and real-world constraints.