The API Changelog

Home
News
Opinion
Documentation
iPaaS
Sponsors
Archive
About

Documentation

Producer-Oriented API Documentation
If API documentation is so important to consumers, how can it also help producers succeed?
 • 
Bruno Pedro
Trying Is a Way to Learn How an API Works
What is better than reading API documentation? Can trying an API be a way to learn how it works?
 • 
Bruno Pedro
API Documentation for Machines
What are the elements that make API documentation easily consumable by a machine?
 • 
Bruno Pedro
Using OpenAPI Overlays to Differentiate Consumer Personas
Is it possible to have a single OpenAPI document that targets different consumer personas?
 • 
Bruno Pedro
An Interactive Approach to API Prototyping Using OpenAPI
Can OpenAPI be the source-of-truth for real-time API prototyping?
 • 
Bruno Pedro
Prototyping APIs with OpenAPI
How can OpenAPI be a tool for quick, low-code API prototyping?
 • 
Bruno Pedro
The Use of Symbology in API Documentation
What is the role of symbology in API Documentation?
 • 
Bruno Pedro
2
Documenting Examples using OpenAPI
Is there any advantage in using OpenAPI to document examples?
 • 
Bruno Pedro
1
Using OpenAPI to Document the API Operations You Consume
Can OpenAPI be a way to catalog and consume third-party API operations?
 • 
Bruno Pedro
4
How Documentation Affects API Quality
If quality depends on consumers' perception, how can API documentation influence it?
 • 
Bruno Pedro
Fill the Gaps between API Consumer Lifecycle Stages
What is the role of documentation in helping consumers navigate their API lifecycle?
 • 
Bruno Pedro
Documenting API Workflows with Arazzo
Having the same source of truth for both machine- and human-readable API workflow documentation is possible.
 • 
Bruno Pedro
© 2025 The API Changelog
Privacy ∙ Terms ∙ Collection notice
Start WritingGet the app
Substack is the home for great culture