Comment and README corrections

corrections and improvements to documentation