minor changes to improve comments, readme