documenting new decorators