Merge pull request OAI#855 from ePaul/patch-1

make path → URL resolution clearer.

Author: darrelmiller

versions/3.0.md

@@ -410,15 +410,15 @@ All the fixed fields declared above are objects that MUST use keys that match th
 
 #### <a name="pathsObject"></a>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
 ---|:---:|---
-<a name="pathsPath"></a>/{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.
+<a name="pathsPath"></a>/{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).