updated notes on functions and references