shadowsyntax
5 months agoNew Contributor
Looking for MkDocs Alternatives That Are Easier to Maintain with CI/CD
We’ve been using MkDocs for internal and public docs, and while it's pretty solid, the manual setup and plugin juggling is starting to become a pain as our team scales and wants a more seamless DevOps flow.
We’re looking for alternatives that:
- Work well with CI/CD pipelines (GitHub Actions, GitLab CI, etc.)
- Can auto-sync from Markdown or OpenAPI specs
- Offer good theme customization
- Support versioning and navigation out of the box
- Ideally have some level of WYSIWYG or preview editing
- Are easier to onboard non-engineers
We’ve tried Docusaurus and Docsify briefly, but would love your real-world input. Bonus if it also reduces the friction between API specs and docs — we’d love to avoid maintaining two separate systems.
What have you switched to after MkDocs, and how’s the DX been?