I was introduced to a new tool, swagger and I
didn't realize the wonderful development trip it would take me on.
I job was to create a cloud application and I was adamant I would work on the server side of the project and leave the GUI to more capable coders.
Swagger creates great
documentation for the rest interface. The definition language uses the OpenAPI specification (formerly known as the Swagger Specification). An OpenAPI document that conforms to the OpenAPI Specification may be represented either in JSON or YAML format. I created my document in YAML format as per the "Petstore" example that comes with the swagger editor.