DOC Fix RocCurveDisplay docstring and parameter order (scikit-learn#31578)

Author: lucyleeow

sklearn/metrics/_plot/roc_curve.py

@@ -59,15 +59,14 @@ class RocCurveDisplay(_BinaryClassifierCurveDisplayMixin):
             Now accepts a list for plotting multiple curves.
 
     name : str or list of str, default=None
-        Name for labeling legend entries. The number of legend entries
-        is determined by the `curve_kwargs` passed to `plot`.
+        Name for labeling legend entries. The number of legend entries is determined
+        by the `curve_kwargs` passed to `plot`, and is not affected by `name`.
         To label each curve, provide a list of strings. To avoid labeling
         individual curves that have the same appearance, this cannot be used in
         conjunction with `curve_kwargs` being a dictionary or None. If a
         string is provided, it will be used to either label the single legend entry
         or if there are multiple legend entries, label each individual curve with
-        the same name. If `None`, set to `name` provided at `RocCurveDisplay`
-        initialization. If still `None`, no name is shown in the legend.
+        the same name. If still `None`, no name is shown in the legend.
 
         .. versionadded:: 1.7
 
@@ -185,7 +184,7 @@ def plot(
 
         name : str or list of str, default=None
             Name for labeling legend entries. The number of legend entries
-            is determined by `curve_kwargs`.
+            is determined by `curve_kwargs`, and is not affected by `name`.
             To label each curve, provide a list of strings. To avoid labeling
             individual curves that have the same appearance, this cannot be used in
             conjunction with `curve_kwargs` being a dictionary or None. If a
@@ -441,9 +440,9 @@ def from_estimator(
             y_score=y_score,
             sample_weight=sample_weight,
             drop_intermediate=drop_intermediate,
+            pos_label=pos_label,
             name=name,
             ax=ax,
-            pos_label=pos_label,
             curve_kwargs=curve_kwargs,
             plot_chance_level=plot_chance_level,
             chance_level_kw=chance_level_kw,
@@ -687,7 +686,7 @@ def from_cv_results(
 
         name : str or list of str, default=None
             Name for labeling legend entries. The number of legend entries
-            is determined by `curve_kwargs`.
+            is determined by `curve_kwargs`, and is not affected by `name`.
             To label each curve, provide a list of strings. To avoid labeling
             individual curves that have the same appearance, this cannot be used in
             conjunction with `curve_kwargs` being a dictionary or None. If a
@@ -783,8 +782,8 @@ def from_cv_results(
         viz = cls(
             fpr=fpr_folds,
             tpr=tpr_folds,
-            name=name,
             roc_auc=auc_folds,
+            name=name,
             pos_label=pos_label_,
         )
         return viz.plot(