diff --git a/prompts/aspnet-minimal-api-openapi.prompt.md b/prompts/aspnet-minimal-api-openapi.prompt.md index 1cfa53892..18fd7cd9b 100644 --- a/prompts/aspnet-minimal-api-openapi.prompt.md +++ b/prompts/aspnet-minimal-api-openapi.prompt.md @@ -22,22 +22,21 @@ Your goal is to help me create well-structured ASP.NET Minimal API endpoints wit - Use record types for immutable request/response objects - Use meaningful property names that align with API design standards - Apply `[Required]` and other validation attributes to enforce constraints +- Use the ProblemDetailsService and StatusCodePages to get standard error responses ## Type Handling - Use strongly-typed route parameters with explicit type binding -- Apply proper parameter binding with `[FromBody]`, `[FromRoute]`, `[FromQuery]` - Use `Results` to represent multiple response types - Return `TypedResults` instead of `Results` for strongly-typed responses - Leverage C# 10+ features like nullable annotations and init-only properties -## OpenAPI / Swagger Documentation +## OpenAPI Documentation -- Add explicit OpenAPI operation details with `.WithOpenApi()` +- Use the built-in OpenAPI document support added in .NET 9 - Define operation summary and description -- Document response types with `.Produces(statusCode)` -- Document request bodies with `.WithRequestBody()` +- Add operationIds using the `WithName` extension method +- Add descriptions to properties and parameters with `[Description()]` - Set proper content types for requests and responses -- Include examples using `SwaggerRequestExampleAttribute` -- Document authentication requirements with `.RequireAuthorization()` -- Use XML documentation comments for descriptive API documentation +- Use document transformers to add elements like servers, tags, and security schemes +- Use schema transformers to apply customizations to OpenAPI schemas