API docs and cleanup of comments
Scala user documentation