From a5370ef0a42c35d89c9df1f61952ff7ae156f0ae Mon Sep 17 00:00:00 2001 From: Sander ten Brinke Date: Tue, 18 Feb 2025 19:57:17 +0100 Subject: [PATCH 1/2] Only show steps for adding packages to the "webapiaot" template if running .NET 9 or lower I also removed the --prerelease flag from the package, no reason to add a prerelease version; AOT works fine without prerelease --- aspnetcore/fundamentals/openapi/aspnetcore-openapi.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/aspnetcore/fundamentals/openapi/aspnetcore-openapi.md b/aspnetcore/fundamentals/openapi/aspnetcore-openapi.md index 9d10200bf2f3..ea8abc422efe 100644 --- a/aspnetcore/fundamentals/openapi/aspnetcore-openapi.md +++ b/aspnetcore/fundamentals/openapi/aspnetcore-openapi.md @@ -239,10 +239,12 @@ Create a new ASP.NET Core Web API (Native AOT) project. dotnet new webapiaot ``` +:::moniker range="< aspnetcore-10.0" + Add the Microsoft.AspNetCore.OpenAPI package. ```console -dotnet add package Microsoft.AspNetCore.OpenApi --prerelease +dotnet add package Microsoft.AspNetCore.OpenApi ``` Update `Program.cs` to enable generating OpenAPI documents. @@ -255,6 +257,8 @@ var app = builder.Build(); + app.MapOpenApi(); ``` +:::moniker end + Publish the app. ```console From b3d952d12a585714fb67cfaa9f7808d555a3fbac Mon Sep 17 00:00:00 2001 From: Sander ten Brinke Date: Wed, 19 Feb 2025 14:06:44 +0100 Subject: [PATCH 2/2] Change the ways monikers are layed out --- aspnetcore/fundamentals/openapi/aspnetcore-openapi.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/aspnetcore/fundamentals/openapi/aspnetcore-openapi.md b/aspnetcore/fundamentals/openapi/aspnetcore-openapi.md index ea8abc422efe..ed6dc5b603e4 100644 --- a/aspnetcore/fundamentals/openapi/aspnetcore-openapi.md +++ b/aspnetcore/fundamentals/openapi/aspnetcore-openapi.md @@ -239,7 +239,9 @@ Create a new ASP.NET Core Web API (Native AOT) project. dotnet new webapiaot ``` -:::moniker range="< aspnetcore-10.0" +:::moniker-end + +:::moniker range="= aspnetcore-9.0" Add the Microsoft.AspNetCore.OpenAPI package. @@ -257,7 +259,7 @@ var app = builder.Build(); + app.MapOpenApi(); ``` -:::moniker end +:::moniker-end Publish the app. @@ -265,6 +267,4 @@ Publish the app. dotnet publish ``` -:::moniker-end - [!INCLUDE[](~/fundamentals/openapi/includes/aspnetcore-openapi6-8.md)]