added notes on functions and blocks