From dec01651b515c1f3b20b972309cfcba3866dabc6 Mon Sep 17 00:00:00 2001 From: Rick Anderson <3605364+Rick-Anderson@users.noreply.github.com> Date: Thu, 17 Apr 2025 17:29:07 -0600 Subject: [PATCH 1/5] ASP.NET Core does not collect metadata from XML doc comments. --- aspnetcore/fundamentals/openapi/include-metadata.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/aspnetcore/fundamentals/openapi/include-metadata.md b/aspnetcore/fundamentals/openapi/include-metadata.md index dd93e53ab704..c644c618c431 100644 --- a/aspnetcore/fundamentals/openapi/include-metadata.md +++ b/aspnetcore/fundamentals/openapi/include-metadata.md @@ -33,8 +33,6 @@ The following table provides an overview of the metadata collected and the strat | responses | [`[Produces]`](xref:Microsoft.AspNetCore.Mvc.ProducesAttribute) | , | | | Excluding endpoints | [`[ExcludeFromDescription]`](xref:Microsoft.AspNetCore.Routing.ExcludeFromDescriptionAttribute), [`[ApiExplorerSettings]`](xref:Microsoft.AspNetCore.Mvc.ApiExplorerSettingsAttribute) | | | -ASP.NET Core does not collect metadata from XML doc comments. - The following sections demonstrate how to include metadata in an app to customize the generated OpenAPI document. ### Summary and description @@ -677,4 +675,4 @@ A schema transformer can be used to override any default metadata or add additio [!INCLUDE[](~/fundamentals/openapi/includes/include-metadata9.md)] -:::moniker-end \ No newline at end of file +:::moniker-end From e985e6a39ee4b92d40ecb89496f6adb0b49397e7 Mon Sep 17 00:00:00 2001 From: Rick Anderson <3605364+Rick-Anderson@users.noreply.github.com> Date: Fri, 18 Apr 2025 10:50:16 -0600 Subject: [PATCH 2/5] Update aspnetcore/fundamentals/openapi/include-metadata.md Co-authored-by: Mike Kistler --- aspnetcore/fundamentals/openapi/include-metadata.md | 1 + 1 file changed, 1 insertion(+) diff --git a/aspnetcore/fundamentals/openapi/include-metadata.md b/aspnetcore/fundamentals/openapi/include-metadata.md index c644c618c431..5bc2ac4753ad 100644 --- a/aspnetcore/fundamentals/openapi/include-metadata.md +++ b/aspnetcore/fundamentals/openapi/include-metadata.md @@ -33,6 +33,7 @@ The following table provides an overview of the metadata collected and the strat | responses | [`[Produces]`](xref:Microsoft.AspNetCore.Mvc.ProducesAttribute) | , | | | Excluding endpoints | [`[ExcludeFromDescription]`](xref:Microsoft.AspNetCore.Routing.ExcludeFromDescriptionAttribute), [`[ApiExplorerSettings]`](xref:Microsoft.AspNetCore.Mvc.ApiExplorerSettingsAttribute) | | | +ASP.NET Core can also collect metadata from XML doc comments. See for more details. The following sections demonstrate how to include metadata in an app to customize the generated OpenAPI document. ### Summary and description From fac7f24572e7fd1381934ea368483eb6b8b547ed Mon Sep 17 00:00:00 2001 From: Rick Anderson <3605364+Rick-Anderson@users.noreply.github.com> Date: Fri, 18 Apr 2025 10:50:36 -0600 Subject: [PATCH 3/5] Update aspnetcore/fundamentals/openapi/include-metadata.md --- aspnetcore/fundamentals/openapi/include-metadata.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/aspnetcore/fundamentals/openapi/include-metadata.md b/aspnetcore/fundamentals/openapi/include-metadata.md index 5bc2ac4753ad..9c477ff0deb9 100644 --- a/aspnetcore/fundamentals/openapi/include-metadata.md +++ b/aspnetcore/fundamentals/openapi/include-metadata.md @@ -33,7 +33,7 @@ The following table provides an overview of the metadata collected and the strat | responses | [`[Produces]`](xref:Microsoft.AspNetCore.Mvc.ProducesAttribute) | , | | | Excluding endpoints | [`[ExcludeFromDescription]`](xref:Microsoft.AspNetCore.Routing.ExcludeFromDescriptionAttribute), [`[ApiExplorerSettings]`](xref:Microsoft.AspNetCore.Mvc.ApiExplorerSettingsAttribute) | | | -ASP.NET Core can also collect metadata from XML doc comments. See for more details. +ASP.NET Core can also collect metadata from XML doc comments. See for more details. The following sections demonstrate how to include metadata in an app to customize the generated OpenAPI document. ### Summary and description From f23ae36af10df6f3d3de67b3db4d115035234733 Mon Sep 17 00:00:00 2001 From: Rick Anderson <3605364+Rick-Anderson@users.noreply.github.com> Date: Fri, 18 Apr 2025 10:51:06 -0600 Subject: [PATCH 4/5] Update aspnetcore/fundamentals/openapi/include-metadata.md --- aspnetcore/fundamentals/openapi/include-metadata.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/aspnetcore/fundamentals/openapi/include-metadata.md b/aspnetcore/fundamentals/openapi/include-metadata.md index 9c477ff0deb9..a86751c69ef3 100644 --- a/aspnetcore/fundamentals/openapi/include-metadata.md +++ b/aspnetcore/fundamentals/openapi/include-metadata.md @@ -33,7 +33,7 @@ The following table provides an overview of the metadata collected and the strat | responses | [`[Produces]`](xref:Microsoft.AspNetCore.Mvc.ProducesAttribute) | , | | | Excluding endpoints | [`[ExcludeFromDescription]`](xref:Microsoft.AspNetCore.Routing.ExcludeFromDescriptionAttribute), [`[ApiExplorerSettings]`](xref:Microsoft.AspNetCore.Mvc.ApiExplorerSettingsAttribute) | | | -ASP.NET Core can also collect metadata from XML doc comments. See for more details. +ASP.NET Core can also collect metadata from XML doc comments. For more information, see for more details. The following sections demonstrate how to include metadata in an app to customize the generated OpenAPI document. ### Summary and description From 8f619bd6a7d2825db2f1f95663c3b1820b0c4103 Mon Sep 17 00:00:00 2001 From: Rick Anderson <3605364+Rick-Anderson@users.noreply.github.com> Date: Fri, 18 Apr 2025 10:59:33 -0600 Subject: [PATCH 5/5] Update aspnetcore/fundamentals/openapi/include-metadata.md --- aspnetcore/fundamentals/openapi/include-metadata.md | 1 + 1 file changed, 1 insertion(+) diff --git a/aspnetcore/fundamentals/openapi/include-metadata.md b/aspnetcore/fundamentals/openapi/include-metadata.md index a86751c69ef3..1f505626f3e8 100644 --- a/aspnetcore/fundamentals/openapi/include-metadata.md +++ b/aspnetcore/fundamentals/openapi/include-metadata.md @@ -34,6 +34,7 @@ The following table provides an overview of the metadata collected and the strat | Excluding endpoints | [`[ExcludeFromDescription]`](xref:Microsoft.AspNetCore.Routing.ExcludeFromDescriptionAttribute), [`[ApiExplorerSettings]`](xref:Microsoft.AspNetCore.Mvc.ApiExplorerSettingsAttribute) | | | ASP.NET Core can also collect metadata from XML doc comments. For more information, see for more details. + The following sections demonstrate how to include metadata in an app to customize the generated OpenAPI document. ### Summary and description