DOC whats new and scope info in docstring.

ogrisel · ogrisel · commit 129d261ab8d7 · 2019-12-24T11:02:11.000+01:00
diff --git a/doc/whats_new/v0.22.rst b/doc/whats_new/v0.22.rst
@@ -28,6 +28,13 @@ Changelog
 - |Fix| :func:`utils.check_array` now correctly converts pandas DataFrame with
   boolean columns to floats. :pr:`15797` by `Thomas Fan`_.
 
+- |Fix| :func:`utils.check_is_fifted` accepts back an explicit ``attributes``
+  argument to check for specific attributes as explicit markers of a fitted
+  estimator. When no explicit attributes are provided, only the attributes
+  ending with a single "_" are used as "fitted" markers. This change is made to
+  restore some backward compatibility with the behavior of this utility in
+  version 0.21. :pr:`15947` by `Thomas Fan`_.
+
 :mod:`sklearn.inspection`
 .........................
 
diff --git a/sklearn/utils/validation.py b/sklearn/utils/validation.py
@@ -857,6 +857,9 @@ def check_is_fitted(estimator, attributes=None, msg=None):
     fitted attributes (ending with a trailing underscore) and otherwise
     raises a NotFittedError with the given message.
 
+    This utility is meant to be used internally by estimators them-selves,
+    typically in their own predict / transform methods.
+
     Parameters
     ----------
     estimator : estimator instance.
