Skip to content

Clarify OpenAPI vs Swagger - part 1 #1244

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.

Sign up for GitHub

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

Closed
wants to merge 1 commit into from
Closed

Clarify OpenAPI vs Swagger - part 1 #1244

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# The OpenAPI Specification (fka The Swagger Specification)
# The OpenAPI Specification (originally cloned from The Swagger Specification)
Copy link
Member

@earth2marsh earth2marsh Jun 30, 2017

Choose a reason for hiding this comment

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

Technically, the spec repo was transferred, not cloned. This isn't a copy of the Swagger spec, it is an evolution.

Copy link
Contributor

@RobDolinMS RobDolinMS Jun 30, 2017

Choose a reason for hiding this comment

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

#TDC: "fka" -> "formerly"


[![Build Status](https://travis-ci.org/OAI/OpenAPI-Specification.svg?branch=master)](https://travis-ci.org/OAI/OpenAPI-Specification)

Expand Down Expand Up @@ -26,7 +26,7 @@ The current version of the OpenAPI specification is 2.0 - and you can find it [h

### [OpenAPI 2.0 Specification](versions/2.0.md)

This repository contains the existing Swagger 1.2, 2.0 specifications as well as proposals for the next version of the specification, which will be called the OpenAPI Specification 3.0. The proposals live in the [OpenAPI.next](https://github.com/OAI/OpenAPI-Specification/tree/OpenAPI.next) branch.
This repository contains the existing Swagger 1.2 and Swagger 2.0 specifications, the OpenAPI Specification 2.0 which is identical to the Swagger 2.0 specification, as well as proposals for the next version of the specification, which will be called the OpenAPI Specification 3.0. The proposals live in the [OpenAPI.next](https://github.com/OAI/OpenAPI-Specification/tree/OpenAPI.next) branch.
Copy link
Member

@earth2marsh earth2marsh Jun 30, 2017

Choose a reason for hiding this comment

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

Suggest: the OpenAPI Specification 2.0, which is identical to the Swagger 2.0 specification but with a new name, (adds comma and emphasizes the name change)


## Structure

Expand Down