doc and code cleanup for similarity metrics