modifying docs and readme for final push to master