You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Please could someone provide some background on the decision to have both .example and .examples[] properties on the requestBody, responses and schemas?
It seems to me this might unnecessarily complicate documentation tooling, while the alternative is simply using a one-element array if only one example is provided. Extending an existing definition with a single example would involve more editing when adding a second one.
An operation object does not have both a .tag and .tags[] properties.
I also found the following wording confusing:
SHOULD be in the correct format as specified [in the] parameter encoding