DOC: fix metrics documentation format

Fixes #2306.