Ask HN: Gitbook Alternatives for API Documentation?
After using Gitbook for our API documentation for the past year, I'm looking to migrate to an open source alternative. While Gitbook has a nice UI, we're increasingly frustrated by things like limitations of their free tier and steep pricing jumps. Also their limited customization for API-specific features like request/response examples.
We're maintaining a growing open source project, and quality API documentation is critical for our adoption. I'm looking for solutions that:
- Support OpenAPI/Swagger integration
- Have good Markdown support
- Generate interactive API documentation
- Offer version control (preferably Git-based)
- Can be easily deployed in our CI/CD pipeline
- Support code samples with syntax highlighting
I've looked at Slate, Docusaurus, ReDoc, and Swagger UI, but I'd appreciate any firsthand experiences or recommendations from the community. What are you using for your API docs, and what has your experience been like with setup, maintenance, and community adoption?