doc: revisions to metrics.py (2)