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 (Videoconference)
Thursday, October 22, 2020 • Enterprise Community
Share the love for this talk
Building a New Home for the Atlassian Design System (Videoconference)
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

  • Inconsistencies between design specs, Figma, Sketch, and code caused user confusion and mistrust of documentation.

  • Atlassian’s Constellation project aims to create a single source of truth unifying designer and developer documentation.

  • Live code examples embedded in documentation replace static images, ensuring up-to-date and interactive component previews.

  • Collaboration and early involvement between designers and engineers are critical to successful design system evolution.

  • The project spanned multiple years and team changes, requiring extensive documentation and ‘run books’ for onboarding.

  • Governance is framed as shared execution rather than policing, fostering buy-in instead of compliance tension.

  • Design tokens improve handoff accuracy, although integration with Figma is still partly manual and evolving.

  • Multiple local design systems coexist alongside the central system, typically as downstream consumers of core components.

  • Roadmap alignment between platform teams and product teams remains one of the biggest operational challenges.

  • Extensive user research including usability tests and tree card sorts informed navigation, IA, and content strategy.

Notable Quotes

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

"If engineers don’t like what we’re doing, they absolutely will not adopt our design system."

"Governance shouldn’t be policing; we’re here to help create the best experience and save time."

"This project has a lot of history and required synthesizing findings from many people over years."

"Design systems reflect organizational structure – if designers and engineers are siloed, no tooling will fix that."

"Updating and adopting design system components requires company time and planning—for some teams, fast release cycles were too frequent to keep up."

"Docs as code is a philosophy that keeps documentation in workflows familiar to content designers and engineers alike."

"Prior prototypes and documentation of pain points helped pave the way and garner stakeholder buy-in for Constellation."

"We use MDX and markdown so designers can edit documentation directly through pull requests."

"Empathy on both sides is key—engineers need scoped work, designers need to understand engineering constraints."

Ask the Rosenbot
Farid Sabitov
Automatization for Large Enterprise Teams
2024 • DesignOps Summit 2020
Gold
Bria Alexander
Charting the future of DesignOps: A community workshop (Videoconference)
2024 • DesignOps Community
Sarah Sgarlato Pierini
From Passion to Execution: A Story of Evolving Research Maturity at LinkedIn
2022 • DesignOps Summit 2022
Gold
Sharbani Dhar
Breathing Room for Delight
2024 • Enterprise Experience 2020
Gold
Tim Parmee
Changing Our Design Pressure Points
2023 • DesignOps Summit 2023
Gold
Tristin Oldani
Turning awareness into action with Climate UX
2025 • Climate UX Interest Group (Rosenfeld Community)
Shazia Ali
Communication: Innovative techniques for making your voice heard [Advancing Research Community Workshop Series]
2024 • Advancing Research Community
Xenia Adjoubei
Empowering Communities Through the Researcher in Residence Program
2023 • Advancing Research 2023
Gold
Maria Giudice
Becoming a Changemaker by Leading with Design
2023 • Advancing Research 2023
Gold
Dan Willis
Filling the Void
2018 • DesignOps Summit 2018
Gold
Jennifer Kong
[Case study] Journeying toward AI-assisted documentation in healthcare
2024 • Designing with AI 2024
Gold
Andy Polaine
What is the role of service design in product-led organizations?
2024 • Advancing Service Design 2024
Gold
Phil Hesketh
Designing Accessible Research Workflows
2021 • DesignOps Summit 2021
Gold
Ash Brown
Silver Linings: What DesignOps Learned in the Shift to WFH
2020 • DesignOps Summit 2020
Gold
Raven Veal
Dark Metrics: Illuminating the Negative Impact of Digital Health Design
2021 • Advancing Research 2021
Gold
Dianne Que
Real Talk: Proving Value through a Scrappy Playbook
2019 • DesignOps Summit 2019
Gold

More Videos

Angelos Arnis

"In a landscape focusing on efficiency and profit, we need to help design transition from production to strategic focus."

Angelos Arnis

Navigating the Rapid Shifts in Tech's Turbulent Terrain

October 2, 2023

John Calhoun

"We want this book to include many voices and practical stories from across the design ops community."

John Calhoun Rachel Posman

Bring your DesignOps Story to Life! The Definitive DesignOps Book Jam

October 3, 2023

Alfred Kahn

"Look at your partnership with product and engineering as a design task—understand their pressures and needs."

Alfred Kahn

A Seat at the Table: Making Your Team a Strategic Partner

November 29, 2023

Dan Willis

"When you accept differences and adjust, you can learn what you’re capable of."

Dan Willis

Enterprise Storytelling Sessions

June 3, 2019

John Maeda

"The pain you feel in driving change is the pain of growth—you have to sign up for it and keep going."

John Maeda Alison Rand

About Design Organizations (Videoconference)

May 13, 2019

Anat Fintzi

"I learned I had to stop asking questions and start telling them what I was thinking, then say tell me what you think."

Anat Fintzi Rachel Minnicks

Delivering at Scale: Making Traction with Resistant Partners

June 9, 2022

Uday Gajendar

"Creating tangible artifacts forces reaction and debate, helping break enterprise paralysis and drive decisions."

Uday Gajendar

The Wicked Craft of Enterprise UX

May 13, 2015

Kristin Skinner

"This is a super exciting time in the brief history of what we’re calling design operations."

Kristin Skinner

Theme 1 Intro

September 29, 2021

Maish Nichani

"Playing the infinite game is like gardening: if you neglect it, things wither, but if you tend it, it thrives. Service excellence requires the same ongoing care."

Maish Nichani

Sparking a Service Excellence Mindset at a Government Agency

December 9, 2021