updated the code comments... more to come