Add notes on `update` operation