updates to comments for clarity