added notes on decorator methods