Hi all, we are trying to setup a docs site for SST...
# general
j
Hi all, we are trying to setup a docs site for SST. I've looked at https://docusaurus.io. Does anybody have any experience with it? Or any alternatives?
a
I have not played with it before, but for your use case it's something I would use. 🎯 Otherwise, you could try Gatsby. Noticed that's what Sentry uses for theirs.
d
https://brainhubeu.github.io/gatsby-docs-kit/docs/getting-started/introduction Here’s the only gatsby docs theme I’ve used. Pretty slick imo.
If you wanna do a little more heavy lifting, something like https://github.com/johno/gatsby-theme-documentation might be better so you will have mdx by default, which I’d def prefer if I was making a docs site
j
Thanks for the suggestions guys! I'll check it out.
k
I just started using Docusaurus for my companies dev documentation. I used V2 https://v2.docusaurus.io/, I think you linked to V1 and I believe I read somewhere on the site that they recommended starting with V2. Don’t quote me on that. It was an easy setup. I also generated sidebar navigation based off this code: https://gist.github.com/rudasn/e4f501cdfa7e066e4a4ecf7804a10894
It’s pretty handy.
j
Thanks for sharing @Kevin Clark! Yeah they say that we should use v2 moving forward. I'm having a go at setting it up now.
k
Have fun!