Rosenverse
Building a New Home for the Atlassian Design System

Log in or create a free Rosenverse account to watch this video.

Log in Create free account

100s of community videos are available to free members. Conference talks are generally available to Gold members.

Building a New Home for the Atlassian Design System

Thursday, October 22, 2020 • Enterprise Community
Share the love for this talk
Building a New Home for the Atlassian Design System
Speakers: Charles Lee and Jennie Yip
Link:

Summary

Having a design system is a de facto necessity when building cohesive enterprise software. The challenge is how does it all come together with a single location, a source of truth, a website? How does a cross-functional team marshal the resources with political and technical willpower to achieve this goal? It’s no easy feat as Jennie Yip, Atlassian design systems lead, explains in this Medium essay. This fireside chat will dig deeper into the problems addressed and lessons learned, with Jennie and also Charles Lee, the engineering lead. Hearing their stories will inspire and inform all of us in our design system journeys. We hope you will join us!

Key Insights

  • •

    Multiple sources of truth in design systems cause inconsistencies and confusion, as seen with the button component font weight differences across specs, design files, and code.

  • •

    Design systems should treat code as the source of truth while making design tools like Figma an integrated extension of that truth.

  • •

    The Constellation project aims to create a single, consistent destination for design and development documentation, consolidating 50+ guidelines and 27 out of 60 components.

  • •

    Collaboration between designers and engineers early in the process is critical to align priorities, avoid scope creep, and build trust.

  • •

    Governance in design systems works best as shared execution through community trust and enabling teams, rather than policing or harsh compliance enforcement.

  • •

    Workshops and detailed documentation are essential for onboarding new team members quickly and preserving knowledge amid team changes.

  • •

    Live code examples embedded in documentation reduce maintenance burdens and ensure consumers always see current component behavior.

  • •

    Versioning pace needs balancing—too frequent releases burden product teams trying to keep up and can hinder adoption.

  • •

    Research methods like card sorting and usability testing directly influence information architecture and navigation improvements in the new documentation.

  • •

    Buy-in from leadership and stakeholders grew through repeated demos and a unified team vision, highlighting the value and reducing skepticism over time.

Notable Quotes

"We kept feeling the same consistent pain around some truths for our design system."

"Kate said she considers live code to be the source of truth because she can't trust the design site due to inconsistencies."

"Code is definitely considered the source of truth; we're working hard to make Figma an extension of that."

"Governance is not policing; we're here to help you create the best experience and save time."

"Workshops often reveal gaps in documentation, which is a spicy take but true."

"It's really about finding a way to link all the different aspects to bring everything together to tell the story."

"Continuous adaptation is key; you're adapting to the system as much as adopting it."

"If you can't get buy-in for collaboration between engineers and designers, start from the bottom and talk more early and often."

"Updating and adopting design system components is company time, so a slower release schedule helps teams keep up."

"We absolutely need feedback loops so engineers and designers can influence the design system and keep it relevant."

Ask the Rosenbot
Alison Rand
Scaling Impact with Service Design
2021 • DesignOps Community
Uday Gajendar
Theme One Intro
2023 • Enterprise UX 2023
Gold
Dan Saffer
Tuning the Turing Machines
2026 • Shift UX 2026
Conference
John Cutler
Prioritization for designers and product managers (1st of 3 seminars)
2024 • Rosenfeld Community
Emily Eagle
Can't Rewind: Radio and Retail
2019 • Enterprise Experience 2019
Gold
Asia Hoe
Partnering with Product: A Journey from Junior to Senior Design
2023 • Design in Product 2023
Gold
Saara Kamppari-Miller
Key Metrics: Comparing Three Letter Acronym Metrics That Include the Word “Key”
2024 • DesignOps Community
Daniel Orbach
Zero to One: Co-Creating Operating Models with your Team
2024 • DesignOps Summit 2024
Gold
Sam Proulx
Understanding Screen Readers on Mobile: How And Why to Learn from Native Users
2023 • DesignOps Summit 2023
Gold
Anna Avrekh
Diversity In and For Design: Building Conscious Diversity in Design and Research
2021 • Design at Scale 2021
Gold
Courtney Kaplan
Taking it to the next level: Career paths in DesignOps
2018 • DesignOps Summit 2018
Gold
Alfred Kahn
A Seat at the Table: Making Your Team a Strategic Partner
2023 • Design in Product 2023
Gold
Marina Martin
Lives on the Line: The Stakes of UX at the Scale of Government
2018 • Enterprise Experience 2018
Gold
Husani Oakley
Theme Three Intro
2023 • Enterprise UX 2023
Gold
Maria Rosala
Research Repositories
2026 • Advancing Research 2026
Gold
Ron Bronson
Design, Consequences & Everyday Life
2022 • Civic Design 2022
Gold

More Videos

Corey Long

"Being humble enough to ask a competitor for feedback changed everything and led directly to job offers."

Corey Long

Hiring in DesignOps: A Critical Study on How to Hire and Get Hired

September 23, 2024

Sarah Auslander

"Civic action as proof of concept to get government moving, to get the wheels turning was really interesting."

Sarah Auslander Betsy Ramaccia Gordon Ross

Insights Panel

November 18, 2022

Lisa Welchman

"Human biases are the real problem behind algorithmic bias because organizations embed those biases first."

Lisa Welchman

Cleaning Up Our Mess: Digital Governance for Designers

June 14, 2018

Lena Shenkarenko

"Every small action counts when it comes to sustainability in urban settings."

Lena Shenkarenko

Collaborative Wireframing for Creating Team Alignment and Shipping Better Products

October 21, 2020

Christian Bason

"Design thinking is really just a set of methodologies; there’s really no thinking in design thinking."

Christian Bason

Expand—Rethinking Design for Public Challenges

September 14, 2022

Nicole Umphress

"A key component is the hands-on experience working on real IBM business unit projects applying enterprise design thinking."

Nicole Umphress

Delivering Design Education During a Global Pandemic: Lessons Learned

June 9, 2022

Jim Kalbach

"Design ops’ job is like jazz rules—it provides a framework so creativity can flow without worrying about inventing structure mid-process."

Jim Kalbach

Jazz Improvisation as a Model for Team Collaboration

November 6, 2017

Bob Baxley

"A society that is designed is better than one that is simply built."

Bob Baxley

Theme 4: Intro

January 8, 2024

Megan Campos

"The viruses don't discriminate based on race, but our healthcare system does."

Megan Campos

What Did I Miss? The Hidden Costs of Deprioritizing Diversity in User Research

March 12, 2021

Latest Books All books