Skip to content

Commit 97f513b

Browse files
authored
Merge pull request #91 from i-ky/fix-typo
Fix a typo
2 parents d499401 + 9d21ff2 commit 97f513b

File tree

1 file changed

+1
-1
lines changed

1 file changed

+1
-1
lines changed

referencing/remove.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ If your OAD does not run afoul of any of the above difficulties, you _can_ produ
2727

2828
## Convert a multi-document OAD into a single document
2929

30-
It is possible to convert a multi-document OAD into a single document event if not all references can be removed. However, depending on exactly how your multi-document OAD is structured, this may be more complex than just removing references. Sadly, the reasons have to do with [painfully obscure and technical ambiguities](https://github.com/OAI/oascomply/blob/main/reports/processing-model-summary.md) regarding how multi-document OADs are intended to be parsed. The OpenAPI Initiative hopes to clarify this in future versions of the specification.
30+
It is possible to convert a multi-document OAD into a single document even if not all references can be removed. However, depending on exactly how your multi-document OAD is structured, this may be more complex than just removing references. Sadly, the reasons have to do with [painfully obscure and technical ambiguities](https://github.com/OAI/oascomply/blob/main/reports/processing-model-summary.md) regarding how multi-document OADs are intended to be parsed. The OpenAPI Initiative hopes to clarify this in future versions of the specification.
3131

3232
* It is possible for a Link Object's `"operationId"` to point to an Operation Object in a Path Item Object that is never referenced; it is unclear how this case should handle it, which is one reason the OAS itself [advises against](https://spec.openapis.org/oas/v3.1.0#fixed-fields-16) using `"operationId"` in multi-document OADs
3333
* Security Scheme Objects are never referenced, only named in Security Requirement Objects, and must be taken into account

0 commit comments

Comments
 (0)