Added scaladoc for all source files, updated README with info on scala, sbt

Note: Since scaladoc has been added to all source files, sbt can auto-generate HTML5 documentation. Doing `sbt doc` will generate the documentation in `target/scala-2.10/api/`