revise README, some comment cleanup

added some documentation