clean up some of the comments
harmonize on readme