More detailed README.md
Scaladoc tidy up