Rosenverse

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
Shahrzad Samadzadeh
What Is My Value? Two Takes and Some Mistakes
2024 • Enterprise Experience 2020
Gold
Adam Cutler
People + Places + Practices = Outcomes
2016 • Enterprise UX 2016
Gold
Farid Sabitov
Automatization for Large Enterprise Teams
2024 • DesignOps Summit 2020
Gold
Charlotte Lee
Theme 1 Intro
2021 • Civic Design 2021
Gold
Tim Parmee
Changing Our Design Pressure Points
2023 • DesignOps Summit 2023
Gold
Steve Portigal
War Stories LIVE! Q&A-Discussion
2020 • Advancing Research 2020
Gold
Louis Rosenfeld
Opening Remarks
2023 • Advancing Research 2023
Gold
Wendy Johansson
Be a Product Boss!
2022 • Design in Product 2022
Gold
Courtney Kaplan
Taking it to the next level: Career paths in DesignOps
2018 • DesignOps Summit 2018
Gold
Smitha Papolu
Theme 3 Discussion
2024 • Enterprise Experience 2020
Gold
Prayag Narula
How to Empower Your Designers to Do Good Research – And Why You Want To
2022 • Design at Scale 2022
Gold
Devon Powers
Imagining Better Futures
2022 • Advancing Research 2022
Gold
Saara Kamppari-Miller
DesignOps for Inclusive Design and Accessibility
2022 • DesignOps Community
Jules Monza
Use These Words and Count These Things
2024 • DesignOps Summit 2024
Gold
Cheryl Platz
Merging Improv with Design
2019 • Enterprise Community
Erin Weigel
Get Your Whole Team Testing to Design for Impact
2024 • Rosenfeld Community

More Videos

Doug Powell

"Design thinking is for everybody. It’s collaborative, inclusive, and cross-disciplinary."

Doug Powell

Closing Keynote: Design at Scale

November 8, 2018

Mila Kuznetsova

"Recruiting kids really means recruiting adults as their proxies and gatekeepers."

Mila Kuznetsova Lucy Denton

How Lessons Learned from Our Youngest Users Can Help Us Evolve our Practices

March 9, 2022

Sarah Gallimore

"Artifacts of the future help us envision and grasp the change that we’re hoping to have—it’s not just bullet points or vision statements."

Sarah Gallimore

Inspire Progress with Artifacts from the Future

November 18, 2022

Lada Gorlenko

"Operations tends to be something companies only think about when they are scaling rapidly, but investing early is essential."

Lada Gorlenko Sharbani Dhar Sébastien Malo Rob Mitzel Ivana Ng Michal Anne Rogondino

Theme 1: Discussion

January 8, 2024

Alnie Figueroa

"AI is just a better version of the tools you’re already using to refine ideas and express thoughts."

Alnie Figueroa

The Future of Design Operations: Transforming Our Craft

September 10, 2025

Landon Barnes

"You shouldn’t send another survey unless you’ve implemented changes and allowed time for behavior to adapt."

Landon Barnes

Are My Research Findings Actually Meaningful?

March 10, 2022

Emily Eagle

"Truly listening can push us beyond empathy to respect and reflection."

Emily Eagle

Can't Rewind: Radio and Retail

June 3, 2019

Malini Rao

"We did a blended approach with a visual refresh first to minimize differences between old and new and buy time."

Malini Rao

Lessons Learned from a 4-year Product Re-platforming Journey

June 9, 2021

Asia Hoe

"Designers are often seen as bottlenecks because our work is harder to estimate and track than engineering’s."

Asia Hoe

Partnering with Product: A Journey from Junior to Senior Design

November 29, 2023