add notes on variable assignment