The API Changelog

Home
News
Opinion
Documentation
iPaaS
Sponsors
Archive
About

Documentation

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
1
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
How to Document Event-Driven API Message Payloads
Documenting event-driven payloads is necessary to promote healthy consumption.
 • 
Bruno Pedro
API Documentation Consumes Attention
Developers consume API Documentation and, in turn, it consumes their attention.
 • 
Bruno Pedro
© 2024 The API Changelog
Privacy ∙ Terms ∙ Collection notice
Start WritingGet the app
Substack is the home for great culture