refactored metric doc to make it simpler. made some changes based on
review.