more comment changes to explain why I chose to write the code I did