added notes on reference docs