
ALT Documenting APIs: new era, same craft With an API, no marketing claim holds up: its quality is measured by the quality of its documentation. Documentation is not an afterthought; it's the API's interface to the world. In this talk, we'll look at what makes API documentation actually useful, starting with the essentials: - The main technical standards and why they matter: OpenAPI, its extensions, and the Arazzo workflow spec. - How to explain the key conventions that the standards don't cover: authentication, errors, pagination, rate limiting, versioning. - Writing guides and tutorials with a product lens, for different user profiles: from someone who just needs a working example to someone who wants to understand the full design. - The state of the ecosystem for documenting your API and building your developer portal. - How to build shared ownership in your team and push a culture of treating docs as a living product Finally, we'll take a look at what has changed for API documenta…































