split the huge yaml file into more manageable sections, based on domains
split the schemas within domains into parameters, requests, and responses, to avoid unnecessary coupling between objects and allow separate versioning.
fixed all linter problems and warnings
added some more explanation on how to keep maintaining tidy spec in the README
This should not change anything for the user experience of the API documentation user.
Most significant changes:
This should not change anything for the user experience of the API documentation user.