filling in docs

experimenting a lot with layout of docs to figure out
how it works. docs for flask-restful-swagger are not
much good...