updated docs to descrive decorator use