Feature/reviewed documentation

- Still some work to be done, will submit a new PR for that.
Also the things below - are both swagger dependencies necessary?