readme updates
more documentation and a changelog