updated some comments for readability