What do you use for technical documentation?
Ask HN: What are you using for public documentation these days?
Does Dev Tool Reviews cover open source tools?
What is Dev Tool Reviews?
How do I find the best tool for my stack?
We love gitbook, but hate the fact the pricing is unpredictable + it's not FOSS :(, so we built something that we could use for our documentation needs. We were big fans of docusaurus and RsPress (like docusaurus but built with rust based tools) but onboarding non-technical people to use it was a pain.
Introducing kalmia! It's free (as in freedom with AGPLv3), it's pretty, it's blazingly fast. If you want to know more details about it you can read about it on our blog or just go straight to the github/docs.
PS: It's a very early stage product so there might be a few bugs/breaking changes!
We have a process that extracts documentation from repos on gitlab which works very nicely.
The last part of that process uses mdbook (rust) to display the documentation and it looks great.
Mdbook was initially used due to its simplicity. However, access to rust crates is currently blocked from a security perspective so I started wondering what alternatives there might be.
I’ve successfully started to replicate mdbook into a Go version that uses the mdbook format so I don’t have to change the output etc and it works pretty well so far, but there’s a fair bit of work left to do.
Before I do that, I wondered what other alternatives people might be using before I go down that path.
I should mention that Hugo maybe seems over complicated for this use case and none of the available templates that I’ve seen look particularly great. I’ve also played with Astro too but keen to avoid JavaScript frameworks.
Sorry for the long post but any feedback appreciated. Thanks.