Doc changes

Author: batterseapower

doc/source/user_guide/advanced.rst

@@ -783,10 +783,12 @@ values **not** in the categories, similarly to how you can reindex **any** panda
 
 .. ipython:: python
 
-   df2.iloc[[0]].reindex(['a', 'e'])
-   df2.iloc[[0]].reindex(['a', 'e']).index
-   df2.iloc[[0]].reindex(pd.Categorical(['a', 'e'], categories=list('abe')))
-   df2.iloc[[0]].reindex(pd.Categorical(['a', 'e'], categories=list('abe'))).index
+   df3 = pd.DataFrame({'A': np.arange(3), 'B': pd.Series(list('abc')).astype('category')})
+   df3 = df3.set_index('B')
+   df3.reindex(['a', 'e'])
+   df3.reindex(['a', 'e']).index
+   df3.reindex(pd.Categorical(['a', 'e'], categories=list('abe')))
+   df3.reindex(pd.Categorical(['a', 'e'], categories=list('abe'))).index
 
 .. warning::
 

doc/source/whatsnew/v1.0.0.rst

@@ -165,7 +165,7 @@ Categorical
 
 - Added test to assert the :func:`fillna` raises the correct ValueError message when the value isn't a value from categories (:issue:`13628`)
 - Bug in :meth:`Categorical.astype` where ``NaN`` values were handled incorrectly when casting to int (:issue:`28406`)
-- For :class:`CategoricalIndex`, `DataFrame.reindex` would fail when the targets contained duplicates, and wouldn't fail if the source contained duplicates (:issue:`28107`)
+- For :class:`CategoricalIndex`, :meth:`DataFrame.reindex` with a :class:`CategoricalIndex`, would fail when the targets contained duplicates, and wouldn't fail if the source contained duplicates (:issue:`28107`)
 -