updated some comments for clarity