Update README.md

cleanup, add inline links to scaladoc