better docstrings for resource fns