Has anyone found a good balance of this is how these components are used / used together for designers using Figma/design library? I want to meet them where they are, but don’t want to make them open the library file each time they have a question.

Not sure I follow the qs

Apologies! So we have a design library, but a very complex product we work on. It’s important to know how and why different components are laid out together. We’ve utilized templates, but there are patterns / rules that templates don’t completely cover.

Sounds like the problem is to keep up with the documentation of the library (which is complex) with the goal of making that understandable by anyone who jumps into that file, correct?

Would a periodic workshop/bootcamp help? Maybe even a loom video if there are not a lot of new updates to the patterns/components.

Good idea! We’ve done workshops here and there, but haven’t touched back since the last new hire in November with a refresh. Could also help getting all this documentation actually documented. 🙃

Or product all hands. We also do that

specific to the library changes? What’s the frequency like?

That’s an interesting topic, but I don’t have a direct answer to that. Where I work we do it in Notion, not sure if that’s what you’re looking for though. Check Campsite too. Anyways I’ll follow the thread for more inputs, cheers:)

I would love to get Notion approved for our use! It’d be easy to link together. We already link up with the components in Storybook, but we keep a lot of that documentation more engineering or product focused than design. All connects, but definitely different audiences.