clean, uniformize the doc, fill in some blanks

[wdevazelhes]

There are some little pbs in the docstrings for example sometime the optional value of an argument is not said, or there are 1 space shift in the alignments somewhere etc... We might want to fix that

[wdevazelhes]

For example, metric_learn.constraints.positive_negative_pairs would maybe need a docstring