Currently the JSON input format is intended to be generated by human users (in the absence of other tools to create it).
It would be better to have a YAML input format for humans to create, that would then compile to a JSON format intended to be created only by software. The JSON format could be more verbose and omit all the "helpful" features that silently insert missing fields when they're omitted. Then the JSON format could generate a more normal OpenAPI schema.
Currently the JSON input format is intended to be generated by human users (in the absence of other tools to create it).
It would be better to have a YAML input format for humans to create, that would then compile to a JSON format intended to be created only by software. The JSON format could be more verbose and omit all the "helpful" features that silently insert missing fields when they're omitted. Then the JSON format could generate a more normal OpenAPI schema.