update comments

Makes the code more readable by anonymous users