From 46e6df481c033a28ad01b55b9f59dde3b7acab8b Mon Sep 17 00:00:00 2001 From: Darrel Miller Date: Thu, 7 Jan 2021 10:36:17 -0500 Subject: [PATCH 1/3] Added wording to clarify scope of references --- versions/3.1.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/versions/3.1.0.md b/versions/3.1.0.md index 16fd23689e..2ab94e5d6c 100644 --- a/versions/3.1.0.md +++ b/versions/3.1.0.md @@ -2235,7 +2235,7 @@ description: Pets operations #### Reference Object -A simple object to allow referencing other components in the OpenAPI document, internally and externally. +A simple object to allow referencing other objects in the OpenAPI document, internally and externally. The target of the reference must match the type required by the context of the reference. Targets of a reference do not need to be contained in a components section and for external references, targets do not need to exist within a valid OpenAPI description. The validity of the target MUST be based on the context of the reference object. ##### Fixed Fields Field Name | Type | Description From 4d18ad17e7889769ed86dd9d021def9ddccabf9b Mon Sep 17 00:00:00 2001 From: Darrel Miller Date: Thu, 7 Jan 2021 13:02:28 -0500 Subject: [PATCH 2/3] Added wording based on conversations in OAI TSC Meeting --- versions/3.1.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/versions/3.1.0.md b/versions/3.1.0.md index 2ab94e5d6c..43e8dde386 100644 --- a/versions/3.1.0.md +++ b/versions/3.1.0.md @@ -2235,7 +2235,7 @@ description: Pets operations #### Reference Object -A simple object to allow referencing other objects in the OpenAPI document, internally and externally. The target of the reference must match the type required by the context of the reference. Targets of a reference do not need to be contained in a components section and for external references, targets do not need to exist within a valid OpenAPI description. The validity of the target MUST be based on the context of the reference object. +A simple object to allow referencing other objects in the OpenAPI document, internally and externally. Targets of a reference do not need to be contained in a components section and for external references, targets MAY exist within any compatible resource. Referenced objects are subject to the same constraints as inline objects. ##### Fixed Fields Field Name | Type | Description From 7aca2a56b66e5a3a9b580bffc3dc013229e567b2 Mon Sep 17 00:00:00 2001 From: Darrel Date: Thu, 14 Jan 2021 12:14:11 -0500 Subject: [PATCH 3/3] Update versions/3.1.0.md --- versions/3.1.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/versions/3.1.0.md b/versions/3.1.0.md index 43e8dde386..11a7abfc25 100644 --- a/versions/3.1.0.md +++ b/versions/3.1.0.md @@ -2235,7 +2235,7 @@ description: Pets operations #### Reference Object -A simple object to allow referencing other objects in the OpenAPI document, internally and externally. Targets of a reference do not need to be contained in a components section and for external references, targets MAY exist within any compatible resource. Referenced objects are subject to the same constraints as inline objects. +A simple object to allow referencing other objects in the OpenAPI document, internally and externally. Targets of a reference do not need to be contained in a components section and for external references, targets MAY exist within any compatible resource. Targets are subject to the same constraints as inline objects. ##### Fixed Fields Field Name | Type | Description