update docs on custom decorators