From cc83c7a8c3bac4d4af10419f2fe2215fd49682e1 Mon Sep 17 00:00:00 2001 From: Kristine Hahn Date: Wed, 7 Jun 2017 05:58:06 -0700 Subject: [PATCH 1/2] strengthen project definition, improve flow --- versions/3.0.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/versions/3.0.md b/versions/3.0.md index 2969ea65c5..d89da313d7 100644 --- a/versions/3.0.md +++ b/versions/3.0.md @@ -8,13 +8,13 @@ This document is licensed under [The Apache License, Version 2.0](http://www.apa ## Introduction -The OpenAPI Specification (OAS) is a project used to describe and document RESTful APIs. +The OpenAPI Specification (OAS) is a project that provides mechanisms to describe and document RESTful APIs. -The OpenAPI Specification defines a set of files required to describe such an API. +The OpenAPI Specification defines a set of files required to describe such APIs. These files can then be used by documentation generation tools to display the API and code generation tools to generate clients in various programming languages. -Additional utilities can also take advantage of the resulting files, such as testing tools. +Additional utilities, such as testing tools, can also use the files. ## Table of Contents From 79138b2d34f1559c018ff0674a0f7f510cb27737 Mon Sep 17 00:00:00 2001 From: Kristine Hahn Date: Fri, 9 Jun 2017 06:43:40 -0700 Subject: [PATCH 2/2] RESTful APIs > singular --- versions/3.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/versions/3.0.md b/versions/3.0.md index d89da313d7..1cd575afb9 100644 --- a/versions/3.0.md +++ b/versions/3.0.md @@ -8,7 +8,7 @@ This document is licensed under [The Apache License, Version 2.0](http://www.apa ## Introduction -The OpenAPI Specification (OAS) is a project that provides mechanisms to describe and document RESTful APIs. +The OpenAPI Specification (OAS) is a project that provides mechanisms to describe and document a RESTful API. The OpenAPI Specification defines a set of files required to describe such APIs.