Documentation not clear when to use v3

[sdudnic-ingerop]

the documentation v3 does not say when to use v3, it only says to remain in v1 or v2

https://github.com/microsoft/OpenAPI.NET/blob/main/docs/upgrade-guide-3.md

If AspNetCore OpenAPI < 10.0 then you must remain on version 1.x as it's not compatible with version 3 or above of this library.

If AspNetCore OpenAPI = 10.0 then you must remain on version 2.x as it's not compatible with version 3 or above of this library.

actually AspNetCore OpenAPI == 10.0.1 what should I use???

[baywet]

Hi @sdudnic-ingerop
Thank you for using the SDK and for reaching out.

I've put together #2668 to clarify this.
Short answer 10.X goes with 2.X :)

Let us know if you have any additional comments or questions.

[sdudnic-ingerop]

Short answer 10.X goes with 2.X :)

so what for the the 3.X version ? there is no 11.X yet

[baywet]

The aspnet team is planning to integrate version 3.X with the aspnet version 11.X. I can't comment on the exact timelines though. But there are multiple issues tracking that you might want to subscribe to:

• OpenAPI 3.2 Support for Server Sent Events dotnet/aspnetcore#64379
• Auto-updates to Microsoft.OpenApi 3.0.0 don't work with .NET 10 dotnet/aspnetcore#64317
• OpenAPI 3.2.0 just released dotnet/aspnetcore#63754