Improve / Add ScalaDoc for public facing APIs #46
Description
Today we don't have much ScalaDocs written as part of our code. One of the things we might have to do for wider adoption is to write sensible documentation what the method does so it's easy for the developers to consume them.