switch to reStructured Text for readme
add some notes to the readme