Documenting your API is critical to its success. To ensure that consumers of your API are successful, you must provide robust documentation. That’s why documenting your API with Stoplight doesn’t only include providing API reference documentation for your internal and external stakeholders, but also other forms of helper documentation such as overviews, guides for authentication, workflows, code samples, and SDKs.
Stoplight allows users to:
To support a holistic approach to documentation, Stoplight’s Markdown API documentation editor allows you to write free-form documentation content. You aren’t restricted to a specific template. This is helpful for all kinds of helper documentation that you write alongside your OpenAPI Specification (formerly known as Swagger) generated API reference docs. You can even write API tutorials based on your OpenAPI Specification. We pushed the limits of API documentation beyond specification and models to accommodate all of the secondary and tertiary information that can help drive good developer experience.
Theming allows you to easily modify color schemes and add textures to your documentation. There are four different theme settings that can be modified: Primary Color, Secondary Color, Background, and Texture.
Want to make your documentation look more like the rest of your site? Add your own custom CSS to enhance your Hub’s look and feel.