Azure / Azure/azure-rest-api-specs
[Docs cleanup] Retire x-ms-* extension authoring docs
Open
Docs
- Dominant language
- TypeSpec
- Stars
- 3.1k
- Forks
- 5.9k
- Avg merge
- 2d 22h
- Merged PRs (30d)
- 444
Description
**Context:** `x-ms-*` extensions are now produced by the TypeSpec emitter rather than hand-added to Swagger.
The docs that teach hand-authoring these extensions should be converted to TypeSpec guidance or archived.
**Tasks:**
- [ ] 🟡 `documentation/x-ms-examples.md` — convert to TypeSpec example guidance, or archive
- [ ] 🟡 `documentation/x-ms-pageable/example1.yaml` — archive as legacy Swagger sample (or convert to TypeSpec)
- [ ] 🟡 `documentation/x-ms-pageable/example2.yaml` — archive as legacy Swagger sample (or convert to TypeSpec)
- [ ] 🟡 `documentation/x-ms-pageable/example3.yaml` — archive as legacy Swagger sample (or convert to TypeSpec)
Contributor guide
Assessment
This issue has not been assessed yet.