a bit of cleanup and documenting changes at the top of the readme.