17 lines
902 B
Markdown
17 lines
902 B
Markdown
# StellaOps API Contracts Guild Charter
|
|
|
|
## Mission
|
|
Maintain OpenAPI 3.1 specifications for every StellaOps service, compose the aggregate spec, and ensure API contract consistency across releases.
|
|
|
|
## Scope
|
|
- Author and review per-service OAS documents in `src/Api/StellaOps.Api.OpenApi/<service>/openapi.yaml`.
|
|
- Operate the aggregate composer producing `src/Api/StellaOps.Api.OpenApi/stella.yaml`.
|
|
- Provide shared components, schema libraries, and example catalogs.
|
|
- Coordinate with service guilds on contract changes, examples, and versioning.
|
|
- Own CI validation, linting, and compatibility diff tooling for OAS artifacts.
|
|
|
|
## Definition of Done
|
|
- All public endpoints represented in OAS with validated request/response examples.
|
|
- Aggregate spec builds deterministically and passes lint + compatibility checks.
|
|
- Change logs generated with every release and linked to developer portal updates.
|