update comments in controllers so it's better understood.