Stoplight Studio

Stoplight Studio is a great tool for REST API Design, modelling and documentation. I like the fact that it has a mock server built in to enable rapid testing and feedback on API design. Like most of these kind of tools out there in the market right now, it is based on the Open API … Continue reading Stoplight Studio

Documenting Events with Async API

Summary: This post explains what the Async API specification is, and how it is used to generate API Reference documentation for events. Introduction Async API is an API specification standard for events. It is used to define and document message driven APIs in a machine and human readable format. It is protocol agnostic, so can … Continue reading Documenting Events with Async API

REST API Documentation Solutions but what about GraphQL ?

Here is a list of REST API documentation solutions. Most of these tools are geared towards generating API Reference Docs from REST APIs specifications defined in OAS, RAML or API Blueprint. Most of these tools follow Slate like templates and layouts learned from the Stripe and Twilio Docs to produce their layout. Saves time and … Continue reading REST API Documentation Solutions but what about GraphQL ?