Skip to content

Commit c4ce7ec

Browse files
authored
Merge pull request #4505 from handrews/no-tag-urif
3.2: Remove promise of URIs for tags, note alternatives
2 parents c32668a + 3a763a4 commit c4ce7ec

File tree

1 file changed

+1
-1
lines changed

1 file changed

+1
-1
lines changed

src/oas.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -215,7 +215,7 @@ This allows Security Scheme Objects and Tag Objects to be defined next to the AP
215215
The interface approach can also work for Discriminator Objects and Schema Objects, but it is also possible to keep the Discriminator Object's behavior within a single document using the relative URI-reference syntax of `mapping`.
216216

217217
There are no URI-based alternatives for the Operation Object's `tags` field.
218-
This limitation is expected to be addressed in a future release.
218+
OAD authors are advised to use external solutions such as the OpenAPI Initiative's Overlay Specification to simulate sharing [Tag Objects](#tag-object) across multiple documents.
219219

220220
See [Appendix F: Resolving Security Requirements in a Referenced Document](#appendix-f-resolving-security-requirements-in-a-referenced-document) for an example of the possible resolutions, including which one is recommended by this section.
221221
The behavior for Discrimator Object non-URI mappings and for the Operation Object's `tags` field operate on the same principles.

0 commit comments

Comments
 (0)