Skip to content

Commit bc29405

Browse files
ePaulPaŭlo Ebermann
authored andcommitted
make path → URL resolution clearer.
You can't append a string to an object (at least not with a canonical result), so we should make clear that we want to append to the `url` field of the server object (possibly after filling in the templates there). The highlighting of "appended" makes it clearer that there is no relative URL resolution as mentioned in OAI#843 (comment).
1 parent 0f730d2 commit bc29405

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

versions/3.0.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -408,15 +408,15 @@ All the fixed fields declared above are objects that MUST use keys that match th
408408

409409
#### <a name="pathsObject"></a>Paths Object
410410

411-
Holds the relative paths to the individual endpoints.
412-
The path is appended to the [`Server Object`](#serverObject) in order to construct
411+
Holds the relative paths to the individual endpoints and their operations.
412+
The path is appended to the URL from the [`Server Object`](#serverObject) in order to construct
413413
the full URL. The Paths MAY be empty, due to [ACL constraints](#securityFiltering).
414414

415415
##### Patterned Fields
416416

417417
Field Pattern | Type | Description
418418
---|:---:|---
419-
<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.
419+
<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.
420420

421421
This object can be extended with [Specification Extensions](#specificationExtensions).
422422

0 commit comments

Comments
 (0)