Overhaul docs using something like GitHub Pages

[markshust]

See https://gibinfrancis.medium.com/creating-structured-multi-page-documentation-with-github-pages-794b100a4941

[markshust]

GitBook may be a good option: https://www.gitbook.com/

Anyone else have suggestions on what documentation platform to use? The only requirement is keeping it editable via GitHub so anyone can contribute to the docs.

[TerrorSquad]

Hey @markshust

I would also recommend Docus https://docus.dev/
It's built with Nuxt, is open-source, has integrated fuzzy search, and allows editing doc files in Markdown files, similar to GitBook, allowing anyone to contribute.

I'm using it for my project https://terrorsquad.github.io/ansible-post-installation/ and it's quite nice.

[markshust]

Thanks for the recommendation @TerrorSquad! That site looks great.

I'll see what I can do coming up here.

[hans2103]

and what about Astro CMS
https://astro.build/

DOCS look like this: https://docs.astro.build/en/getting-started/
Works nice too.

[markshust]

@hans2103 My personal site actually runs on Astro, and while cool and seemingly good at the start, it feels like it tends to slow down a bit with large numbers of files. I'll take an additional look at it though, as my site was built a few years back, and I'm sure the build process and loading speeds have probably improved dramatically since.