Skip to content

Documentation not clear when to use v3 #2667

Description

@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???

Activity

  1. baywet commented on Jan 6, 2026

    @baywet
    Member

    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.

  2. sdudnic-ingerop commented on Jan 6, 2026

    @sdudnic-ingerop
    Author

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

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

  3. baywet commented on Jan 6, 2026

    @baywet
    Member

    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:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

type:documentationGeneral documentation request or project documentation update

Type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions