Added more detail to readme, #136

Not closing 136 until I have thought what to do with scaladoc.