add convenience function docstring