changes to documentation
add a few more points on the readme