From 2c2f6dea925213a62e5ce58e970ec39a8ff6ece4 Mon Sep 17 00:00:00 2001 From: Laurent Mazuel Date: Fri, 11 Sep 2026 10:56:43 -0700 Subject: [PATCH] Update Azure README with TypeSpec link Removed OpenAPI Style Guidelines link and added TypeSpec link. --- azure/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/azure/README.md b/azure/README.md index 1daae552..00a2896c 100644 --- a/azure/README.md +++ b/azure/README.md @@ -1,10 +1,10 @@ # Azure REST API Guidance When building software components that will be used by developers to build other software, providing APIs that are easy to use, fit to purpose, scalable, maintainable, and consistent across your product can make the difference between success and failure for your software. -Designing powerful APIs with strong defaults, consistent behavior across related projects, and ease of use for developers arises from putting yourself in the shoes of the person using your interfaces, and taking their concerns to heart. The APIs you ship can have a dramatic long term effect on the health of your software product, and that is why the **REST API Stewardship Board** is here to help! We have published a collection of best practices, REST guidance, and OpenAPI style guidelines to help you create an amazing developer experience. +Designing powerful APIs with strong defaults, consistent behavior across related projects, and ease of use for developers arises from putting yourself in the shoes of the person using your interfaces, and taking their concerns to heart. The APIs you ship can have a dramatic long term effect on the health of your software product, and that is why the **REST API Stewardship Board** is here to help! We have published a collection of best practices, and REST guidance to help you create an amazing developer experience. * [Considerations for Service Design](ConsiderationsForServiceDesign.md) * [REST API Guidelines](Guidelines.md) -* [OpenAPI Style Guidelines](https://github.com/Azure/azure-api-style-guide/blob/main/README.md) +* [TypeSpec](https://typespec.io/) * [Versioning policy for Azure services, SDKs, and CLI tools](https://learn.microsoft.com/en-us/azure/developer/intro/azure-service-sdk-tool-versioning) * [Breaking Changes](https://aka.ms/azapi/breakingchanges) Note: Internal Microsoft link