add notes on code issues