adding documentation to metrics