Currently I’m using GitBook for our API documentation, but it’s starting to feel a bit limiting, especially when integrating with our CI/CD pipeline. I’m exploring alternatives that offer better customization and collaboration features. Any recommendations for tools that have worked well for your teams?
Perhaps mkdocs? Or eventually Hugo?
1 Like
https://antora.org/ is pretty great if you think asciidoc is a good idea.
1 Like
I see a couple of first-time posts advertising apidog from accounts created 12h ago. Might be a coincidence but 
Can’t comment for OP but I personally would also prefer open-source software where possible, which apidog is not.
3 Likes
I’ve had reasonable success using mdBook for generating docs in GitHub CD pipeline. When paired with tools like mdsh to generate dynamic examples in the preprocessor step, it can do wonders.
I don’t believe it offers anything particular for collaboration though, it’s just a way to neatly render markdown that has to be edited through standard means.
1 Like
For what it worth, doing a bit of self publicity…
I recently published my first open source rust project. You can find it here: First python project - markdown-code-runner
The tool is already used for the nix documentation and I also use it for some other projects.
Let me know if this helps.