changed according to comments

Author: topper-123

doc/source/whatsnew/v0.24.0.txt

@@ -557,8 +557,7 @@ Categorical
 ^^^^^^^^^^^
 
 - Bug in :meth:`Categorical.from_codes` where ``NaN`` values in `codes` were silently converted to ``0`` (:issue:`21767`). In the future this will raise a ``ValueError``. Also changes the behavior of `.from_codes([1.1, 2.0])`.
-- :meth:`Categorical.searchsorted` and :meth:`CategoricalIndex.searchsorted`
-  now work on unordered categoricals also (:issue:`21667`)
+- :meth:`Categorical.searchsorted` and :meth:`CategoricalIndex.searchsorted` now work on unordered categoricals also (:issue:`21667`)
 -
 
 Datetimelike

pandas/core/base.py

@@ -1169,13 +1169,12 @@ def factorize(self, sort=False, na_sentinel=-1):
 
         .. note::
 
-            The %(klass)s *must* be monotonically sorted, else wrong
-            index locations may be returned. Pandas does *not* check
-            this for you.
+            The %(klass)s *must* be monotonically sorted, otherwise
+            wrong locations will likely be returned. Pandas does *not*
+            check this for you.
 
             You can check sortedness by calling
-            ``is_monotonic_increasing/is_monotonic_decreasing`` on the
-            Series or Index.
+            :meth:`%(klass)s.is_monotonic_increasing`.
 
         Parameters
         ----------
@@ -1214,7 +1213,7 @@ def factorize(self, sort=False, na_sentinel=-1):
         dtype: int64
 
         >>> x.searchsorted(4)
-        array([3])  # Note: an array, not a scalar
+        array([3])
 
         >>> x.searchsorted([0, 4])
         array([0, 3])

pandas/tests/arrays/categorical/test_analytics.py

@@ -70,46 +70,45 @@ def test_mode(self, values, categories, exp_mode):
         exp = Categorical(exp_mode, categories=categories, ordered=True)
         tm.assert_categorical_equal(res, exp)
 
-    @pytest.mark.parametrize("ordered", [True, False])
     def test_searchsorted(self, ordered):
         # https://github.com/pandas-dev/pandas/issues/8420
         # https://github.com/pandas-dev/pandas/issues/14522
 
-        c = Categorical(['cheese', 'milk', 'apple', 'bread', 'bread'],
-                        categories=['cheese', 'milk', 'apple', 'bread'],
-                        ordered=ordered)
-        s = Series(c)
+        cat = Categorical(['cheese', 'milk', 'apple', 'bread', 'bread'],
+                          categories=['cheese', 'milk', 'apple', 'bread'],
+                          ordered=ordered)
+        ser = Series(cat)
 
         # Searching for single item argument, side='left' (default)
-        res_cat = c.searchsorted('apple')
-        res_ser = s.searchsorted('apple')
+        res_cat = cat.searchsorted('apple')
+        res_ser = ser.searchsorted('apple')
         exp = np.array([2], dtype=np.intp)
         tm.assert_numpy_array_equal(res_cat, exp)
         tm.assert_numpy_array_equal(res_ser, exp)
 
         # Searching for single item array, side='left' (default)
-        res_cat = c.searchsorted(['bread'])
-        res_ser = s.searchsorted(['bread'])
+        res_cat = cat.searchsorted(['bread'])
+        res_ser = ser.searchsorted(['bread'])
         exp = np.array([3], dtype=np.intp)
         tm.assert_numpy_array_equal(res_cat, exp)
         tm.assert_numpy_array_equal(res_ser, exp)
 
         # Searching for several items array, side='right'
-        res_cat = c.searchsorted(['apple', 'bread'], side='right')
-        res_ser = s.searchsorted(['apple', 'bread'], side='right')
+        res_cat = cat.searchsorted(['apple', 'bread'], side='right')
+        res_ser = ser.searchsorted(['apple', 'bread'], side='right')
         exp = np.array([3, 5], dtype=np.intp)
         tm.assert_numpy_array_equal(res_cat, exp)
         tm.assert_numpy_array_equal(res_ser, exp)
 
         # Searching for a single value that is not from the Categorical
-        pytest.raises(ValueError, lambda: c.searchsorted('cucumber'))
-        pytest.raises(ValueError, lambda: s.searchsorted('cucumber'))
+        pytest.raises(ValueError, lambda: cat.searchsorted('cucumber'))
+        pytest.raises(ValueError, lambda: ser.searchsorted('cucumber'))
 
         # Searching for multiple values one of each is not from the Categorical
         pytest.raises(ValueError,
-                      lambda: c.searchsorted(['bread', 'cucumber']))
+                      lambda: cat.searchsorted(['bread', 'cucumber']))
         pytest.raises(ValueError,
-                      lambda: s.searchsorted(['bread', 'cucumber']))
+                      lambda: ser.searchsorted(['bread', 'cucumber']))
 
     def test_unique(self):
         # categories are reordered based on value when ordered=False