[MRG] DOC: more consistency in metrics docstrings

This set off some of my quirks when looking at the new metrics documentation (I guess before it was well hidden in the class reference). It's a small PR but I'd rather not merge straight away because some things might be rather written differently. For example F_1 instead of F1, or F_beta instead of F-beta.