Background
The Azure REST API Specs repository has transitioned toward TypeSpec as the primary authoring experience. However, the documentation folder still contains guidance that references legacy AutoRest-based workflows, tooling, configurations, and processes.
Actions
- Review documents under documentation for legacy AutoRest references.
- Remove obsolete content that no longer provides value.
- Add deprecation notices where historical guidance should remain available for reference.
- Update links and references to point to TypeSpec-based workflows and tooling.
- Ensure service teams can easily identify the recommended authoring and validation experience.
Out of Scope
- Functional changes to TypeSpec tooling.
- SDK generation pipeline changes.
- Changes outside the documentation directory unless required to fix broken references.
Background
The Azure REST API Specs repository has transitioned toward TypeSpec as the primary authoring experience. However, the documentation folder still contains guidance that references legacy AutoRest-based workflows, tooling, configurations, and processes.
Actions
Out of Scope