minor code reshaping, added README.md
README.md fixups
resolve of remote repo inconsistency