Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add support for versioning #2129

Draft
wants to merge 1 commit into
base: master
Choose a base branch
from
Draft

add support for versioning #2129

wants to merge 1 commit into from

Conversation

goetas
Copy link
Collaborator

@goetas goetas commented Aug 16, 2023

This pull request allows to define a versioning strategy per model.

im not 100% sure it is the best approach. a different strategy is to have different versions of the API defined using "areas" (that would allow also to not clutter the latest api doc with "old" version infos.

The question is: one document per version or a single document with versions handled by media types?

reason i prefer this approach is (instead of areas):

  • you do not need to send to the user multiple urls for different api versions
  • the user still sees the old data models (eventually described as deprecated)

@shakaran
Copy link
Contributor

shakaran commented May 1, 2024

@goetas could you rebase with last updates? Thanks

@lacatoire
Copy link
Contributor

maybe a line for the doc too, to be used ;)

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.

3 participants