update docstrings for metrics