[CraigJPerry]

Just been going through a bunch of docs as code solutions trying to find something i like.

I’m troubled by how slow and complicated some build process are. Docusaurus wasn’t the worst offender here although it has more moving parts than i’d like.

If you’re still using Sphinx it might be worth a quick scan of the latest tools, the search facilities are quite good in some nowadays.

So far hugo has my attention the most. Setting up other devs is as simple as checking out the repo (hugo binary is tiny and doesnt need to change often so could even just be vendored into the repo if you wanted).

1 command to checkout even if you’re a dev from another team.

1 to build, and build is fast with live reload.

Docsy theme gets out of the way and just works. I think doks theme looks more user friendly to my eye but the build process is encumbered by mandatory npm deps.

[slorber]

The end result is a little bit different. Docusaurus builds an SPA, page state is preserved when navigating and it makes it easy to interleave React components inside your doc.

Hugo is a more traditional SSG. Definitively faster to build than any Webpack/Babel alternative.

I have good hopes that SPA SSGs will become faster with esbuild, swc, sucrase.

[alexktz]

I tried dozens in the space and it sounds like you have too.

I settled on mkdocs for perfectmediaserver.com but hugo was up there too. mdbook is another great contender.

There are lots of almost what I want options. In the end mkdocs-material was close enough and I needed to ship.