cleanup and comments
Merge branch 'master' of github.com:synyker/distsys_cats
readme fixin