At one point we considered calling what is now called definitionsschemas instead. We opted for definitions, but the operation declaration still uses a key called schema. Perhaps that should be changed to definition for a better match?
I think this is OK. The #/definitions is JSON schema convention, and inside that location, a schema exists. So referring from schema to the definitions object is fine.
At one point we considered calling what is now called
definitions
schemas
instead. We opted fordefinitions
, but the operation declaration still uses a key calledschema
. Perhaps that should be changed todefinition
for a better match?