DOC: sub-section on boolean Index array changes

closes #17740

Author: jreback

doc/source/whatsnew/v0.21.0.txt

@@ -356,6 +356,37 @@ Selection with all keys found is unchanged.
 
  s.loc[[1, 2]]
 
+.. _whatsnew_0210.api_breaking.loc_with_index:
+
+Indexing with a Boolean Index
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Previously when passing a boolean ``Index`` to ``.loc``, if the index of the ``Series/DataFrame`` had ``boolean`` labels,
+you would get a label based selection, potentially duplicating result labels, rather than a boolean indexing selection
+(where ``True`` selects elements), this was inconsistent how a boolean numpy array indexed. The new behavior is to
+act like a boolean numpy array indexer. (:issue:`17738`)
+
+Previous Behavior:
+
+.. ipython:: python
+
+ s = pd.Series([1, 2, 3], index=[False, True, False])
+
+.. code-block:: ipython
+
+ In [59]: s.loc[pd.Index([True, False, True])]
+ Out[59]:
+ True 2
+ False 1
+ False 3
+ True 2
+ dtype: int64
+
+Current Behavior
+
+.. ipython:: python
+
+ s.loc[pd.Index([True, False, True])]
 
 .. _whatsnew_0210.api_breaking.pandas_eval: