[DOC] Calibration example

[bellet]

It would be nice to have an example in the doc which demonstrates how to calibrate the pairwise metric learners with respect to several scores as introduced in #168, as well as the use of CalibratedClassifierCV (once this is properly tested, see #173)