Some scaladoc tweaks
Updated the README