added some commentary

small refinements