Skip to content

Commit 9eee465

Browse files
committed
Backport improved OpenAPI specification intro paragraph from 3.1.1 (original PR OAI#3387)
1 parent 3e304ee commit 9eee465

File tree

1 file changed

+1
-1
lines changed

1 file changed

+1
-1
lines changed

versions/3.0.4.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,7 @@ An OpenAPI definition can then be used by documentation generation tools to disp
6868
## Definitions
6969

7070
##### <a name="oasDocument"></a>OpenAPI Description
71-
A document (or set of documents) that describes an API. An OpenAPI Description (OAD) uses and conforms to the OpenAPI Specification.
71+
An OpenAPI Description (OAD) formally describes the surface of an API and its semantics. It is composed of an [entry document](#documentStructure) and any/all of its referenced documents. An OAD uses and conforms to the OpenAPI Specification.
7272

7373
##### <a name="pathTemplating"></a>Path Templating
7474
Path templating refers to the usage of template expressions, delimited by curly braces ({}), to mark a section of a URL path as replaceable using path parameters.

0 commit comments

Comments
 (0)