search

dotnet / AspNetCore.Docs

Documentation for ASP.NET Core
https://docs.microsoft.com/aspnet/core
Creative Commons Attribution 4.0 International
12.39k stars 25.33k forks source link

Post-PR review. #32562

Closed tdykstra closed 2 weeks ago

tdykstra commented 3 weeks ago

Review of the article created by #32529

Mostly changes to conform to the style guide. On periods in bulleted lists, see https://styleguides.azurewebsites.net/Styleguide/Read?id=2700&topicid=56575

Internal previews

📄 File 🔗 Preview link
aspnetcore/fundamentals/minimal-apis/aspnetcore-openapi.md Get started with Microsoft.AspNetCore.OpenApi
Rick-Anderson commented 3 weeks ago

Search and replace here -- too verbose



ADD the OpenAPI-related services to `Program.cs`: <!-- REPLACE FOLLOWING WITH SNIPPET -->```
Rick-Anderson commented 3 weeks ago
image
Rick-Anderson commented 3 weeks ago

. The requests below will resolve the v1 and internal documents respectively. The following requests resolve (nuke will)

remove all FT.

Rick-Anderson commented 3 weeks ago

Split up

Transformers are useful for scenarios like:

  • adding parameters to all operations in a document,
  • modifying descriptions for parameters or operations,
  • adding top-level information to the OpenAPI document.
Rick-Anderson commented 3 weeks ago

https://github.com/dotnet/aspnetcore/blob/main/src/OpenApi/src/Services/OpenApiOptions.cs

Rick-Anderson commented 3 weeks ago

useTransformer in https://github.com/dotnet/aspnetcore/blob/main/src/OpenApi/src/Services/OpenApiOptions.cs#L47