Giving advice about design systems is almost impossible. Every team and codebase is wildly different from one another and what works for one company now might not work for the same company in the near future. I’ve noticed this at Gusto too, where lessons that I learned in the very beginning no longer apply to what our team has become.
That’s to say that design systems work is super weird!
However, if there is one bit of advice that I would apply to every company and every design systems team no matter what it’s this: you need to start writing and publishing an internal newsletter about design systems.
Thanks to Brad Azevedo, a front-end engineer on our design systems team at Gusto, we’ve been publishing these newsletters on a semi-regular basis now. We write about what’s shipped in our library, any updates to components we’ve made, as well as any challenges we’re facing at that moment in time. And almost immediately we noticed a change in how our team is viewed across the company; engineers reached out to us for more advice and feedback, leads began looped us into more conversations earlier on in the process, and designers are now working with our team to develop components that can be shared across our system.
I would say that this humble newsletter is perhaps the best thing our team has done for quite some time. And you should start one, too.
Design systems: A million problems poorly defined
One of the strangest things about a design systems team at a company is that it’s not really a product team, but a platform team. This means that a lot of the work that a team does on a day to day basis is incredibly boring, infrastructure work, and almost all of it is invisible and under the hood. Most of this work will go entirely unnoticed by anyone else in the org, despite how crucial that work might be if the company wants a healthy design system.
One example is refactoring the styles of your core web app, or adding documentation for a
Card component. These small projects solve minor problems today but over weeks and months they build up into something remarkable. However, the problem with a lot of this work is that it doesn’t impact designers and engineers at your company today. And that lack of visibility makes things difficult for other teams on the outside to learn what your design systems team is doing and why. This, in turn, will make it harder to make hiring requests, to get buy-in for a design system, and to encourage folks to use the design system when they need it.
Over the past couple of months our team has been listening to every designer and engineer at Gusto to get their feedback about what we’re doing right and wrong. And we’ve heard a flurry of questions from them: How does this work impact my team? What is the design systems team up to? What is the component library? Why did you change this one component or this particular page? And despite our incredible velocity and the wonderful changes our small team is shipping each week, some designers and engineers even felt that we weren’t doing anything at all!
So a few weeks ago we thought about ways to tackle these communication and transparency problems. We saw how some design systems teams at other companies have an internal web app that has a list of everything they’re working on for that quarter. Others have written about the benefits of office hours, too. But neither of these solutions felt like they could solve this problem alone. Instead, we started making notes about everything we’d been working on and everything we’d been fixing that week. Today it all starts in Notion, where we make a scrappy list to help us chat about things:
This is just a place where we can argue privately about what we want to discuss and what’s worth mentioning. But this leads to something that’s even more important than the content, perhaps.
Figuring out the tone and audience
Our team often considers the best way to communicate with everyone at Gusto, as we believe that the design system isn’t just for designers and engineers but for everyone in every department. This means that we have to think about our audience and how designers can follow along with the more technical aspects of the work whilst engineers can understand and appreciate the design-led initiatives.
On this note, there’s a great piece by Linzi Berry, the Design Systems Lead at Lyft, where she writes about design systems and empathy:
“Systems design is not only scientific and meticulous, it’s the mastery of interacting with people in a sensitive and effective way. It takes human connection and empathy to go from a sticker sheet to a living, thriving system. The time we invest in relationships with designers and engineers (and their bosses, their bosses’ boss, their project managers, and the accessibility guru down the hall) is as important as building the system itself.”
The only problem with this piece is that I wish Linzi had written it three years ago. That’s when I stared on the design systems team and believed that I alone could code or design my way out of any design systems problem. Alas, you must talk to people if you want to build a great system. You must reach out to everyone, designers and engineers alike, and help teach folks about the benefits of working within that system. The best way to start that little community? A newsletter.
Linzi continues with a one-two punch:
“It’s important to remain positive when communicating with others because we are the physical embodiment of the system. If we are easy to work with, so is the system. If we are intimidating, so is the system.”
With this in mind the tone of each newsletter must be upbeat and jovial. It must bring everyone into the fold, with kindness in every sentence and every project we write about. In these newsletters we must try as hard as we can to also make design systems…fun.
Goals of the newsletter
It’s important to think about what each edition of this newsletter should accomplish. If we’ve only worked on structural issues for the week then perhaps we can reach back into our archive of work and see if there’s something else our audience would find more interesting or useful. But here are some of the high level goals we’re thinking about for each newsletter:
- Make sure our work is transparent for designers, engineers, product managers, and senior leadership.
- Teach folks about the value of our work and how we can help solve complex UI issues across the organization.
- Show before and after screenshots of big projects we’ve tackled so people can see the scale and breadth of our work.
- Discuss what projects we’ll be working on in the near future and why it will be useful to the rest of the organization.
- Create a common language for our components and our system.
That last part is especially important as I‘ve noticed designers might call an app component “stickies” when the component is actually called
Notifications in the codebase. These small communication errors lead to big implementation issues, so our newsletter is the place to build a friendly lexicon of terms and phrases that everyone in the company can share.
What should we publish?
I think visual changes and component updates should lead the way, as they’re a lot more effective in garnering attention than the more infrastructure-led work that we do. In this month’s newsletter we introduced things with our brand new
StepList component that we built alongside another team in the company:
We record each entry in a Google doc so folks can scan through an archive of our work if they want to but we also send them a plaintext version via email. This is a great way to foster partnerships and show how other teams might be able to collaborate with us. It’s also a great opportunity to link to a Figma doc that breaks down all the different use cases of this component, or perhaps an audit instead. This is one of the greatest benefits of using Figma on our design team at Gusto, as we can easily add links to mockups in our internal communications like our newsletter.
The list that we make in Notion goes a long way into helping us discuss what should and shouldn’t go into each edition. We want to make it as short and sweet as possible, and we want everyone to be able to see what we’re up to. By focusing on why we’re working on each project, and the impact after the fact, we can begin to spread the good word about our team.
After our first newsletter we had a ton of feedback from engineers, designers, and leaders at the company — and each appeared shocked as to just how much we could get done in such a small amount of time.
When should we publish them?
Well, Mondays are often when everyone in the company is packed with meetings and 1-on-1s as everyone is trying to figure out the shape of their week. And Fridays are generally very quiet in the office as lots of folks work from home. So those two days are probably less likely for folks to read the email. This led us to send the email on Wednesday afternoons to make sure that as many people have time to read it as possible.
Also, the cadence is important, too. If we publish these newsletters too frequently it might look like we’re not up to much, whereas if we publish them too infrequently (say, once a month) then folks will feel less included in the process of our work. Once every other week feels right for our team at the moment, but we’ll also be sharing updates about our work in person on a regular basis, too (such as Engineering and Product Design All-Hands meetings).
This feels like a lot of repetitive work and communication – but this outreach work is absolutely vital to the success of a good system, especially at the beginning when a team is just forming around design systems. Maybe folks didn’t catch that Slack message about the new UI Kit! Maybe they didn’t see your new component in the library! Communication is extraordinarily complex at large companies with gigantic systems and the way to combat some of that is to be consistent (and maybe a bit loud) about your message.
Wrapping things up
With design systems work there is always more to be done and barely any time to sit back and see all the improvements your team has made. So the other nice thing about the newsletter is that once the announcements are out there in public it all starts to feel a bit more complete. It’s wonderful to see folks noticing the work that is making their lives easier and more efficient in the long run.
The newsletter is also a great place to talk about things we could do better on our team. Perhaps we broke a component that wasn’t fixed immediately. Why was that? How do we avoid issues like this in the future? Creating an open forum and discussion around our thinking helps folks understand that we’re not just breaking things and being complete jerks. And this is important because any issues we cause in our design system that impacts other features risks damaging the trust we’ve built with everyone at Gusto, — so we need to be extremely sensitive to anything that we change in our product.
Finally, I think it’s wonderful to have a record of everything we’ve built. It’s neat to see how that one project we started a month ago ties into this other project that we just wrapped up today. It boosts morale for the team and makes us all feel proud of the work we’ve been doing. Everything feels a bit more tangible after you hit send on that email. But these newsletters are also becoming a story that we can use to teach folks how we work—by making the smallest of changes each and every day, and improving things just by 1%.
Get started today by writing a short email that details your progress and plans! It’s by far the most effective thing that you can do for your design system—the revolution may not be televised, but it will certainly begin in a humble newsletter.