flesh out docstrings for the Catalog API