Great git, markdown and openapi integrations
Use Cases and Deployment Scope
We use Stoplight for public and private documentations for our SaaS APIs.
All APIs are described in OpenAPI yaml format by the developers themselves and deployed to a gateway after being edited and published from Stoplight and validated by CI jobs.
Public docs have addional markdown files to describe important topics, like authentication.
Pros
- OpenAPI support
- Markdown supports
- Git integration
Cons
- Support for multiple environments could be easier
Likelihood to Recommend
Its well suited as an easy way to centralize documentations, [especially] if you already use openapi format.
