aspnet-openapi-docs

Generates and shapes OpenAPI documents for ASP.NET Core services running on .NET 10 with the built-in Microsoft.AspNetCore.OpenApi package, without Swashbuckle. Covers service registration, gated serving of the spec file, response metadata from TypedResults unions, XML doc comment prose, document, operation, and schema transformers, security requirements derived from real authorization metadata, named documents for separate audiences, and build-time emission for reviewable diffs and client generation. Use when the user wants API documentation added or customized on net10.0, Swashbuckle replaced, auth surfaced in a spec, public and internal specs split apart, or mentions AddOpenApi, MapOpenApi, TypedResults, transformers, OpenAPI 3.1, Kiota, or NSwag. Not for runtimes before .NET 10, non-.NET stacks, REST resource design, or interactive docs UI packages that merely consume the generated file.

Version

v1.0.0

Size

18 KB

Updated

2026-10-10

Your client verifies the signature before reading. This explicit manual read is available on every plan. Free automatically loads five chosen skills; paid plans automatically load relevant skills across the library.