Services / API reference

API Reference Documentation from OpenAPI

Generated reference output is a starting point, not documentation. Descriptions, worked examples and honest error tables are what turn a schema dump into something a developer can integrate against.

What the work covers

  • Write up endpoint and reference websites with your team
  • Using Swagger and OpenAPI to create a self-updating API site.
  • Integrate it into CI/CD process to auto-update and publish

Related: Docs-as-code CI/CD pipelines · Antora and Docusaurus sites

Need reference documentation? Contact me here!

Email All services