more docs tweaks for metrics