Improved clarity of doc and APIs based on Sid's comments.
Note: This commit changes the name of the Metrics class to MetricsRepository, which makes it backwards-incompatible with the Tehuti 0.4 release.