is it ok to contribute and openapi spec to the project.
is it better to include a yaml or a json or both?

json is preferred for machines, yaml can keep comments (human information)