search

OAI / OpenAPI-Specification

The OpenAPI Specification Repository
https://openapis.org
Apache License 2.0
28.91k stars 9.07k forks source link

Full Version History #180

Closed techtonik closed 11 months ago

techtonik commented 9 years ago

There is no information about differences between versions of Swagger. It will be nice to know why a certain version was not sufficient and new speccy appeared. https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md#revision-history

webron commented 8 years ago

Parent: #589.

lornajane commented 11 months ago

Closing as outdated and somewhat addressed. Newer versions of OpenAPI specification have transparent change processes and discussion.

techtonik commented 10 months ago

@lornajane historical info is never outdated. I wouldn't close this issue in case there is still somebody who can fill the gap.

handrews commented 10 months ago

@techtonik there's no simple reason for a version to be considered in need of updating or replacement- it's the ongoing discussions documented in this repository's issues and PRs that tell that story (and the OAI/moonwalk repository for the next major version). Existing published versions aren't changed once published, so if you really think there are specific things that need documenting, you could file issues requesting documentation of those specifics at the OAI/learn.openapis.org repository.

techtonik commented 4 months ago

The main reason for Full Version History information in any spec is to have information about how to (back)port tools and data from one version to another. Sometimes you need to backport things to an older spec for some complicated piece of software to do its job.