Context: As part of archiving AutoRest tooling and the move to TypeSpec-only specs (OpenAPI is now
generated via tsp compile), the hand-authored Swagger authoring guides no longer describe a supported
workflow. This issue tracks retiring/rewriting them.
Legend: 🔴 OBSOLETE (delete/archive) · 🟡 NEEDS-UPDATE (reword)
⚠️ The typespec-autorest emitter is the current OpenAPI-from-TypeSpec emitter and must NOT be removed.
Tasks:
Context: As part of archiving AutoRest tooling and the move to TypeSpec-only specs (OpenAPI is now
generated via
tsp compile), the hand-authored Swagger authoring guides no longer describe a supportedworkflow. This issue tracks retiring/rewriting them.
Legend: 🔴 OBSOLETE (delete/archive) · 🟡 NEEDS-UPDATE (reword)
Tasks:
documentation/creating-swagger.md— delete/archive; AutoRest + Swagger 2.0 authoring referencedocumentation/swagger-extensions.md— delete/archive; pointer to AutoRest extensionsdocumentation/swagger-bootstrap.json— delete/archive; hand-authored Swagger 2.0 starter templatedocumentation/openapi-authoring-manual-guidelines.md— delete, or reduce to a review-only pointerdocumentation/Getting started with OpenAPI specifications.md— retire/redirect to TypeSpec getting-started ("we only support Swagger 2.0")documentation/swagger-authoring-descriptions.md— rewrite for TypeSpec@doc/decorators, or retiredocumentation/swagger-checklist.md— retarget to TypeSpec/generated-OpenAPI validation; drop any AutoRest validator if they are no longer needed.