what is the reason for using Gatsby for docs site?April 12, 2020 at 11:09am
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.