Replace all of the current method comments with proper Scaladocs annotations. Also generate the documentations using `scaladocs`, see [here](http://alvinalexander.com/scala/how-to-generate-scala-documentation-scaladoc-command-examples) for more info.
