add docs for decorator methods