update method comments