Epic tracking the rollout of the Unified Examples Format in Azure/typespec-azure — a single examples.yaml per service that replaces ~282K individual x-ms-examples JSON files.
RFC: https://github.com/Azure/azure-rest-api-specs/blob/rfc/unified-examples-format/documentation/rfc/unified-examples-format.md
Examples are authored once per service in YAML, version-aware via since, joined to Swagger operations through an x-id extension. Version ordering comes from service.yaml (see the service.yaml epic).
Rollout
Child issues are attached as sub-issues below.
Epic tracking the rollout of the Unified Examples Format in
Azure/typespec-azure— a singleexamples.yamlper service that replaces ~282K individualx-ms-examplesJSON files.RFC: https://github.com/Azure/azure-rest-api-specs/blob/rfc/unified-examples-format/documentation/rfc/unified-examples-format.md
Examples are authored once per service in YAML, version-aware via
since, joined to Swagger operations through anx-idextension. Version ordering comes fromservice.yaml(see the service.yaml epic).Rollout
examples.yamlJSON Schema +examples-validateexamples-migratetoolexamples-resolvetoolx-idemission:typespec-autorest+ transitional JSONexamples-scaffold+examples-diffexamples.yamlx-ms-examplesJSON filesChild issues are attached as sub-issues below.