Are there any decent documentation platforms for documenting design systems?
over 4 years ago from Joseph Berthelot, CEO
Looking for a platform to use for internal and external documentation as well as design system docs. What do you guys use?
over 4 years ago from Joseph Berthelot, CEO
Looking for a platform to use for internal and external documentation as well as design system docs. What do you guys use?
I recommend Zeroheight in combination with Figma/Sketch and Storybook
There are many tools for documenting design systems. Just as there have been for a very long time many tools for creating styleguides (like Frontify). By interviewing lots of teams, we found that static documentation always ends up dying in a corner.
It's been almost two years since we started working on Specify (specifyapp.com), a tool halfway between production tools like Zeplin and documentation tools. We believe documentation should be dynamic and be in sync with design tools & production code.
While we are still in alpha the coming months will be very exciting! :)
"A single source of truth for consistency at scale" – Invision DSM.
This may be the most jargon I've seen in so few words.
ZeroHeight is pretty amazing, but it isn't quite integrated enough with production for me.
Hey Andrew, thanks for your kind words! I'm a founder of zeroheight :) Closer integration with the dev production environment is on our roadmap!
I'm also looking for the holy grail for documentation. I'm yet to try it, Gitbook looks pretty good - https://www.gitbook.com/
Keen to know what other people are using?
Gitbook looks a lot like Notion, but built on top of Github. Is that an accurate comparison?
We're using Storybook https://storybook.js.org/ on a project and digging it. It involves code, so not sure if it fits the prompt. We've also built what we call a "sandbox" before, which is basically frontend/design docs.
Gitbook looks to be closest to what I'm looking for. If only there were a cheaper alternative with white-labeling. I may consider building an open-source clone. Thank you!
Yeah, it looks pretty sweet... I might have to take it for a spin.
https://zeroheight.com/ Looks like a great product. I've been testing it with our UI Kit, and am happy with the results... so far. It seems to play nice with solutions that are catered to design or development teams.
I quite like https://www.catalog.style/ It's very simple to fill out, but does require a little dev knowledge to set up.
This looks pretty cool, thank you!
At work, I'm still doing in design documentation, It is a combination of Sketch/Figma + Zeplin. However, it's not great for scale, terrible for discoverability and searchability, but great for direct communication with the team that you are working with.
Storybook is always talked about for living web component with documentation. https://storybook.js.org/
I have seen some people using Notion with good results https://www.notion.so/
Overall, whichever approach you use, it's good to find the right fit for your team and the documentation strategy that the team is adopting. It's really down to how you want to communicate and maintain it. Really like how designbetter.co sum up on the team model. https://www.designbetter.co/design-systems-handbook/designing-design-system
I asked this question few weeks ago and got down voted to hell. Well, at least now I get some answers.
Edit: Emojis are messing the posts.
UXPIN - UXPin.com has a design system solution that also works with Sketch
Hi, I am also still looking for something easy & intuitive.
We did take a look at several tools, like gitbook, fractal, Gatsby.js, Cogear.js, Zeroheight, InVision DSM, Storybook, Confluence etc.
So far we still work with our own solution which is basically a light weight CMS based on markdown JSON files.
But we are not 100% satisfied so still looking. We might try out Cogear.js as we are developing with angular and not react.
Hey Timo! Founder of zeroheight here - I'd love to know what was missing for you in zeroheight so we can improve it :) :)
Designer News
Where the design community meets.
Designer News is a large, global community of people working or interested in design and technology.
Have feedback?
Login to Comment
You'll need to log in before you can leave a comment.
LoginRegister Today
New accounts can leave comments immediately, and gain full permissions after one week.
Register now