updated the read me to be fairly thoroughly documented