From 2d2b1130bce70072d543ae0916de9d4ed4bf0988 Mon Sep 17 00:00:00 2001 From: Timothee Guerin Date: Fri, 23 Oct 2026 15:02:34 -0400 Subject: [PATCH 1/4] Update README.md --- README.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/README.md b/README.md index 085c26288..62ff12aa6 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,13 @@ +# ⚠️ Deprecation Notice + +**AutoRest is deprecated and will be retired on July 1, 2026.** + +AutoRest is no longer under active development. No new features, language generators, or plugins will be added. + +### ✅ Recommended replacement: TypeSpec + +The recommended successor to AutoRest is **[TypeSpec](https://typespec.io/)** — a modern, actively developed API description language and code generation platform. + # azure-openapi-validator For a deep-dive on this tool, please see https://aka.ms/lintdiff. From 52e8e65789fc2d90d48df302803f152035c74c72 Mon Sep 17 00:00:00 2001 From: Timothee Guerin Date: Fri, 23 Oct 2026 15:03:04 -0400 Subject: [PATCH 2/4] Apply suggestion from @timotheeguerin --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 62ff12aa6..5096c5d70 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # ⚠️ Deprecation Notice -**AutoRest is deprecated and will be retired on July 1, 2026.** +**AutoRest and its plugins are deprecated and will be retired on July 1, 2026.** AutoRest is no longer under active development. No new features, language generators, or plugins will be added. From 574ef1fd4c68f3184e134e2ea201cff9db672c77 Mon Sep 17 00:00:00 2001 From: Timothee Guerin Date: Fri, 23 Oct 2026 15:07:44 -0400 Subject: [PATCH 3/4] Update deprecation notice and linting rules policy Added a note that no new linting rules will be accepted and directed users to add TypeSpec rules for the Azure ecosystem. --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 5096c5d70..52e14c0ef 100644 --- a/README.md +++ b/README.md @@ -8,6 +8,8 @@ AutoRest is no longer under active development. No new features, language genera The recommended successor to AutoRest is **[TypeSpec](https://typespec.io/)** — a modern, actively developed API description language and code generation platform. +**⚠️ No new linting rule will be accepted**. For azure ecosystem add TypeSpec rules here https://github.com/azure/typespec-azure + # azure-openapi-validator For a deep-dive on this tool, please see https://aka.ms/lintdiff. From 2fd0f88099d37af83ad37e6e5654aaee0cf9d145 Mon Sep 17 00:00:00 2001 From: Timothee Guerin Date: Fri, 23 Oct 2026 15:23:17 -0400 Subject: [PATCH 4/4] Make the new lint rule policy visible to contributors --- .github/ISSUE_TEMPLATE/new_lint_form.yml | 9 ++++++--- .github/PULL_REQUEST_TEMPLATE.md | 3 +++ ISSUE_TEMPLATE/new_lint_form.yml | 9 ++++++--- 3 files changed, 15 insertions(+), 6 deletions(-) create mode 100644 .github/PULL_REQUEST_TEMPLATE.md diff --git a/.github/ISSUE_TEMPLATE/new_lint_form.yml b/.github/ISSUE_TEMPLATE/new_lint_form.yml index 6cf1ae0e7..2ab301fb0 100644 --- a/.github/ISSUE_TEMPLATE/new_lint_form.yml +++ b/.github/ISSUE_TEMPLATE/new_lint_form.yml @@ -1,5 +1,5 @@ name: New Lint Rule Request -description: request a new lint rule +description: New rules are not accepted here; propose Azure rules in Azure/typespec-azure. title: "[new rule]: " labels: ["linter", "rule"] assignees: jianyxi,ruoxuanwang @@ -7,8 +7,11 @@ body: - type: markdown attributes: value: | - This form is to collect lint rule candidate for swagger validation. We will evaluate collected candidates in Swagger reviewer meeting in regular basis. For qualified candidates, swagger team will either prioritize to add them to validation tool, or document them as manual rules must be conformed in swagger authorization. If any question, please mail to Swagger and Tools Team (vscswagger@microsoft.com). - To avoid duplicate, please refer to the following two documents for all existing rules: + > **No new lint rules are being accepted in this repository.** + > + > Please propose new Azure lint rules in [Azure/typespec-azure](https://github.com/Azure/typespec-azure). + + For existing Swagger validation guidelines, see: Automated guidelines: https://github.com/Azure/azure-rest-api-specs/blob/master/documentation/openapi-authoring-automated-guidelines.md Manual guidelines: https://github.com/Azure/azure-rest-api-specs/blob/master/documentation/openapi-authoring-manual-guidelines.md - type: textarea diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 000000000..879f0eff8 --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,3 @@ +> **No new lint rules are being accepted in this repository.** +> +> Please propose new Azure lint rules in [Azure/typespec-azure](https://github.com/Azure/typespec-azure). diff --git a/ISSUE_TEMPLATE/new_lint_form.yml b/ISSUE_TEMPLATE/new_lint_form.yml index 6cf1ae0e7..2ab301fb0 100644 --- a/ISSUE_TEMPLATE/new_lint_form.yml +++ b/ISSUE_TEMPLATE/new_lint_form.yml @@ -1,5 +1,5 @@ name: New Lint Rule Request -description: request a new lint rule +description: New rules are not accepted here; propose Azure rules in Azure/typespec-azure. title: "[new rule]: " labels: ["linter", "rule"] assignees: jianyxi,ruoxuanwang @@ -7,8 +7,11 @@ body: - type: markdown attributes: value: | - This form is to collect lint rule candidate for swagger validation. We will evaluate collected candidates in Swagger reviewer meeting in regular basis. For qualified candidates, swagger team will either prioritize to add them to validation tool, or document them as manual rules must be conformed in swagger authorization. If any question, please mail to Swagger and Tools Team (vscswagger@microsoft.com). - To avoid duplicate, please refer to the following two documents for all existing rules: + > **No new lint rules are being accepted in this repository.** + > + > Please propose new Azure lint rules in [Azure/typespec-azure](https://github.com/Azure/typespec-azure). + + For existing Swagger validation guidelines, see: Automated guidelines: https://github.com/Azure/azure-rest-api-specs/blob/master/documentation/openapi-authoring-automated-guidelines.md Manual guidelines: https://github.com/Azure/azure-rest-api-specs/blob/master/documentation/openapi-authoring-manual-guidelines.md - type: textarea