Skip to content

Conversation

@Rick-Anderson
Copy link
Contributor

@Rick-Anderson Rick-Anderson commented Feb 15, 2025

@Rick-Anderson Rick-Anderson marked this pull request as ready for review February 15, 2025 01:00
Copy link
Contributor Author

@Rick-Anderson Rick-Anderson left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@mikekistler I copy/pasted your markup from the P1 issue and merged into main. This PR shows the diffs. If you remember, don't add newlines unless you need a new line. The diff is a bit hard to read because I've removed newlines.

I think rich diff is the most productive way to see what has changed.

Comment on lines -3 to -4
https://github.com/dotnet/aspnetcore/pull/59480
https://github.com/dotnet/aspnetcore/pull/60002
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Duplicate PR, is there another? I added the PR at the end of the H3

- Instead of a `nullable: true` property, they have a `type` keyword whose value is an array that includes `null` as one of the types.

With this feature, the default OpenAPI version for generated documents will be `3.1` . You can easily change the version
by explicitly setting the [OpenApiVersion](/dotnet/api/microsoft.aspnetcore.openapi.openapioptions.openapiversion?view=aspnetcore-9.0) property of the [OpenApiOptions](/dotnet/api/microsoft.aspnetcore.openapi.openapioptions?view=aspnetcore-9.0) in the `configureOptions` delegate parameter of [AddOpenApi](/dotnet/api/microsoft.extensions.dependencyinjection.openapiservicecollectionextensions.addopenapi?view=aspnetcore-9.0).
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@mikekistler can you check these links (click on them in the build)

```

Note that these changes will be necessary even if you congfigure the OpenAPI version to 3.0.
The following example shows the changes in diff format.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@mikekistler should I delete the before/after code and just have the diff? I prefer the diff.

@Rick-Anderson Rick-Anderson merged commit 63ab6cf into main Feb 15, 2025
3 checks passed
@Rick-Anderson Rick-Anderson deleted the WN/rick/p1 branch February 15, 2025 02:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

WN10 edit include Response description on ProducesResponseType WN 10: Edit OpenAPI include file and Add to WN10 doc

2 participants