menu
announcement

Spectrum is now read-only. Learn more about the decision in our official announcement.

Primer

For discussing Primer, Octicons, our style guide, and design systems at GitHub 🤖🎨

Channels
Team

what is the reason for using Gatsby for docs site?

April 12, 2020 at 11:09am

what is the reason for using Gatsby for docs site?

April 12, 2020 at 11:09am
Hi everyone,
I'm trying to figure out the best practices and tools when creating the design system hence exploring primer. From primer docs:
To borrow a metaphor from Brad Frost, the docs site is Primer CSS's storefront, and Storybook is its workshop.
However, Storybook does provide /addon-docs which can be used for similar purpose. Can anyone help me to understand the reason behind choosing to create a separate Gatsby docs site?
Thanks in advance.

June 26, 2020 at 2:23pm
I think this just comes down to personal preference. I've used React Styleguidist (https://react-styleguidist.js.org/) before. Systems like Evergreen even make their own custom docs site. Depends on how much control you want over you docs site, but that does come with a tradeoff, more technical and design debt.