address review comments.  Renaming a lot of things and adding more
details to readme.