add docs for decorators