Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

GitHub Organization Repositories

GitHub organizations provide teams with the ability to create repositories for managing API contracts, separating and organizing contracts by meaningful bounded contexts within a specific domain.

Strategies

API Development Is Collaborative Across Teams

API development must be a collaborative effort across product, engineering, and operations teams, with shared workspaces, design reviews, and cross-functional feedback loops that ensure APIs reflec...

Lifecycle

dns Domains Define

Every API begins with the domain it serves. Before I write a single line of a definition I get clear on the business domain, the bounded context, and who owns it, because the domain is what keeps a...

description Definitions Define

The definition is the contract. OpenAPI, AsyncAPI, JSON Schema, and APIs.json are the machine-readable artifacts I use to describe what an API is before, during, and after it exists. Investing in s...