mirror of
https://github.com/docker/docs.git
synced 2026-10-23 18:09:02 +03:00
9b1f7de05f
@netlify /reference/api/ [Preview the API reference](https://deploy-preview-26048--docsdocker.netlify.app/reference/api/) Adds a shared API reference experience for Hub, DVP, and Registry: a catalog, operation navigation, linked schemas, request and response examples, and matching HTML and Markdown output. A validation and generation pipeline prepares the reference data for Hugo and runs as part of Docker and Netlify builds. Migrates the three specifications to OpenAPI 3.2, correcting response shapes, nullable fields, and authentication and token examples. The Hub migration also corrects SCIM contracts and CSV exports; DVP gains complete report response schemas and examples. Registry keeps its documented Hub-specific subset, with authentication and media negotiation expressed through OpenAPI security and content fields. Validation is strict for both checks and generation, with no exception baseline or bypass flag. The build uses the migrated sources directly, without migration scripts or records. Page and specification URLs remain stable, including the DVP alias. Operation and schema anchors change. Engine and Governance retain their existing references. Validated locally with Go tests, strict validation of all three specifications (zero diagnostics), scoped formatting and lint, and a full Hugo build checking all 176 HTML/Markdown page pairs, example parity, reference links, and byte-identical published specifications. A browser check confirmed raw CSV rendering and the generated request header. No live API requests were made.
25 lines
748 B
YAML
25 lines
748 B
YAML
# Structural and dialect validation run against locked OAI schemas in the Go command.
|
|
# Vacuum supplies independently named Docker policy rules with source locations.
|
|
rules:
|
|
docker-operation-id:
|
|
description: Every operation needs a stable operation ID.
|
|
severity: error
|
|
given: $.paths[*][get,put,post,delete,options,head,patch,trace,query]
|
|
then:
|
|
field: operationId
|
|
function: truthy
|
|
docker-info-description:
|
|
description: Every API needs an overview.
|
|
severity: error
|
|
given: $.info
|
|
then:
|
|
field: description
|
|
function: truthy
|
|
docker-info-version:
|
|
description: Every API needs a version identity.
|
|
severity: error
|
|
given: $.info
|
|
then:
|
|
field: version
|
|
function: truthy
|