added comments for field updating code