hrennau

JSON Schema Core - 11.1/11.2 - link relation type "schema" not explained

13

JSON Schema Core - 11.2: "HTTP can also send the "schema" in a Link, though this may impact media-type semantics and Content-Type nogotiation if this replaces the media-type parameter entirely:...

XML Object - unfortunate default rule for name changes

1

In the OpenAPI spec, section "XML Object", https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#xmlObject the examples show a default rule which I think is a bad decision. Consider the case (see also spec example at the...

Examples table with confusing notes

3

In the OpenAPI spec, section "Link Object", https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#linkObject the "Examples" table following after the text "The table below provides examples of runtime expressions and examples of their use in a...

A few broken $ref s

10

In the OAS documents downloaded today (2021-03-09), a few references were observed: ``` Resource azure.com:network-virtualNetwork.json . ./networkInterface.json#/definitions/NetworkInterfaceTapConfiguration docusign.net.json . #/definitions/offlineAttributes payrun.io.json . #/definitions/JournalExpressionDataTable . #/definitions/ThirdPartyTransaction shutterstock.com.json . #/components/schemas/AssetId . #/components/schemas/AssetUploadId...

JSON Schema, fundamentally - expression based assertions

14

Issue 823 "Precision and Scale for Decimal Values" illustrates a fundamental question - which kinds of constraints are general enough to warrant inclusion in the standard vocabulary? In cases of...

XML Object - an incomprehensible sentence

1

In the OpenAPI spec, section "XML Object", https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#xmlObject the examples contain text which appears to me incomprehensible: > The examples of the XML object definitions are included inside a property...