updated some documentation in decorators.py