New Swagger API doc

New OBS API Documentation

We are rewriting our documentation using Swagger

As guide, we are using https://swagger.io/docs/specification/about/

How to test it:

start the development environment and point your browser to http://localhost:3000/apidocs-new/index.html

CAVEATS

Some people experience problems with Swagger and Rails, specially when a file get changed, either Rails doesn't reload it or browser caches it. To the second issue, normally running the browser in incognito helps.