I would be even more explicit and add something like:

In un-calibreated confidence estimates are sufficient (e.g. to compare pairwise predictions on the same model) it is advised to leave ``probability`` to ``False`` and use the ``decision_function`` method instead.