improve metadata docstrings