diff --git a/versions/3.0.md b/versions/3.0.md index bb9ef288dc..062a639d82 100644 --- a/versions/3.0.md +++ b/versions/3.0.md @@ -408,15 +408,15 @@ All the fixed fields declared above are objects that MUST use keys that match th #### Paths Object -Holds the relative paths to the individual endpoints. -The path is appended to the [`Server Object`](#serverObject) in order to construct +Holds the relative paths to the individual endpoints and their operations. +The path is appended to the URL from the [`Server Object`](#serverObject) in order to construct the full URL. The Paths MAY be empty, due to [ACL constraints](#securityFiltering). ##### Patterned Fields Field Pattern | Type | Description ---|:---:|--- -/{path} | [Path Item Object](#pathItemObject) | A relative path to an individual endpoint. The field name MUST begin with a slash. The path is appended to the [`Server Object`](#serverObject) in order to construct the full URL. [Path templating](#pathTemplating) is allowed. +/{path} | [Path Item Object](#pathItemObject) | A relative path to an individual endpoint. The field name MUST begin with a slash. The path is **appended** (no relative URL resolution) to the expanded URL from the [`Server Object`](#serverObject)'s `url` field in order to construct the full URL. [Path templating](#pathTemplating) is allowed. This object can be extended with [Specification Extensions](#specificationExtensions).