Feature/reviewed documentation

- Still some work to be done, will submit a new PR for that.
Is this the json library that you decided on? As I was talking about the other day I think that it might be interesting to have a look at the json libraries used by the Play framework - in particular if that is what we will then build our front-end in. (`"com.typesafe.play" %% "play-json" % "2.3.4"`)