1. apidoc
2. documenting APIs
3. OpenAPI spec and generated reference docs
4. Demos of OpenAPI outputs

Stoplight Demo

I’ve provided information about Stoplight in two other places in this course:

• Create an OpenAPI specification document using Stoplight Studio’s visual editor
• Stoplight — visual modeling tools for creating your OpenAPI spec

Here I include a short demo of how Stoplight renders the OpenAPIWeatherMap OpenAPI specification document that we’ve been using in this course. (Click the following image to see the details.)

This sample API doesn’t include many endpoints, so it might be more instructive to see some other samples of Stoplight listed on their Case Studies page. For more direct links to the documentation mentioned in case studies, explore the following:

• Zoom API docs
• Nutanix API docs
• MediaMath API docs
• AppointmentPlus API docs
• BigCommerce API docs
• Namely API docs

Note that Stoplight lets you mix both the API reference documentation along with the conceptual content, so it provides a more seamless experience across all of your documentation.