Azure / Azure/typespec-azure

Delete all x-ms-examples JSON files

Open
#4,841 0 comments 0 reactions 0 assignees View on GitHub
eng feature triaged:core
Dominant language
TypeScript
Stars
27
Forks
90
Avg merge
1d 22h
Merged PRs (30d)
156

Description

**Target: January 2027**

Part of #4831.

RFC: https://github.com/Azure/azure-rest-api-specs/blob/rfc/unified-examples-format/documentation/rfc/unified-examples-format.md (§9 Phase 4)

**Delete all legacy `x-ms-examples` JSON files** from the repo — the new `examples.yaml` becomes the sole source of truth, with JSON generated on demand if still needed.

### Scope
- Remove the per-version `examples/*.json` files across all services.
- Confirm no remaining consumer reads the JSON files directly (all joined via `x-id`).

Depends on #4840 (old example tooling disabled).

Contributor guide

Open the contributing guide

Research direction

Read RFC §9 Phase 4 and review #4840 to confirm the old example tooling is disabled. Inventory per-version examples/*.json files and check consumers that join through x-id rather than reading JSON directly. Done means the legacy JSON files are removed across services with no remaining direct consumers.

Written by the indexing model from the issue text.

Assessment

Domain
tooling
Issue type
Refactor
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.