diff --git a/versions/3.0.md b/versions/3.0.md index 2969ea65c5..1cd575afb9 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 a RESTful API. -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