Skip to content

Commit 2c0f912

Browse files
cebewebron
andauthored
Explain unclear semantics of property $ref in Path Item Object (#1964)
* Explain unclear semantics of property `$ref` in Path Item Object Currently, as explained in #1038 (comment) the description of `$ref` in [Path Item Object](https://github.com/OAI/OpenAPI-Specification/blob/3.0.2/versions/3.0.2.md#pathItemObject) is unclear about the semantics behing it. I took the explaination from issue #1038 to make it more clear. * Update versions/3.0.3.md Co-authored-by: Ron <[email protected]>
1 parent d2cd322 commit 2c0f912

File tree

1 file changed

+1
-1
lines changed

1 file changed

+1
-1
lines changed

versions/3.0.3.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -736,7 +736,7 @@ The path itself is still exposed to the documentation viewer but they will not k
736736

737737
Field Name | Type | Description
738738
---|:---:|---
739-
<a name="pathItemRef"></a>$ref | `string` | Allows for an external definition of this path item. The referenced structure MUST be in the format of a [Path Item Object](#pathItemObject). If there are conflicts between the referenced definition and this Path Item's definition, the behavior is *undefined*.
739+
<a name="pathItemRef"></a>$ref | `string` | Allows for an external definition of this path item. The referenced structure MUST be in the format of a [Path Item Object](#pathItemObject). In case a Path Item Object field appears both in the defined object and the referenced object, the behavior is undefined.
740740
<a name="pathItemSummary"></a>summary| `string` | An optional, string summary, intended to apply to all operations in this path.
741741
<a name="pathItemDescription"></a>description | `string` | An optional, string description, intended to apply to all operations in this path. [CommonMark syntax](https://spec.commonmark.org/) MAY be used for rich text representation.
742742
<a name="pathItemGet"></a>get | [Operation Object](#operationObject) | A definition of a GET operation on this path.

0 commit comments

Comments
 (0)