README.rst: add more prominent documentation line
freshen up the docs a little

Add a little more meat to the introduction for the library.
prepare for 0.5 release