DOC: put more emphasis on r2_score
@@ -673,8 +673,11 @@ def explained_variance_score(
is set to ``False``, this score falls back on the original :math:`R^2`
definition.
- Note: when the prediction residuals have zero mean, the Explained Variance
- score is identical to the :func:`R^2 score <r2_score>`.
+ .. note::
+ The Explained Variance score is similar to the
+ :func:`R^2 score <r2_score>`, with the notable difference that it
+ does not account for systematic offsets in the prediction. Most often
+ the :func:`R^2 score <r2_score>` should be prefered.
Read more in the :ref:`User Guide <explained_variance_score>`.
@@ -718,6 +721,12 @@ def explained_variance_score(
score : float or ndarray of floats
The explained variance or ndarray if 'multioutput' is 'raw_values'.
+ See Also
+ --------
+ r2_score :
+ Similar metric, but accounting for systematic offsets in
+ prediction.
+
Notes
-----
This is not a symmetric function.
