DOC: Fixing EX01 - Added examples (pandas-dev#53502)

Added examples

Author: DeaMariaLeon

ci/code_checks.sh

@@ -82,14 +82,8 @@ if [[ -z "$CHECK" || "$CHECK" == "docstrings" ]]; then
     $BASE_DIR/scripts/validate_docstrings.py --format=actions --errors=EX01 --ignore_functions \
         pandas.Series.backfill \
         pandas.Series.pad \
-        pandas.Series.str.normalize \
-        pandas.Series.str.rfind \
-        pandas.Series.str.rindex \
-        pandas.Series.str.translate \
         pandas.Series.sparse \
         pandas.DataFrame.sparse \
-        pandas.Series.cat.categories \
-        pandas.Series.cat.ordered \
         pandas.Series.cat.codes \
         pandas.Series.cat.reorder_categories \
         pandas.Series.cat.set_categories \

pandas/core/arrays/categorical.py

@@ -748,13 +748,35 @@ def categories(self) -> Index:
         remove_categories : Remove the specified categories.
         remove_unused_categories : Remove categories which are not used.
         set_categories : Set the categories to the specified ones.
+
+        Examples
+        --------
+        >>> ser = pd.Series(["a", "b", "c", "a"], dtype="category")
+        >>> ser.cat.categories
+        Index(['a', 'b', 'c'], dtype='object')
+
+        >>> raw_cat = pd.Categorical(["a", "b", "c", "a"], categories=["b", "c", "d"],)
+        >>> ser = pd.Series(raw_cat)
+        >>> ser.cat.categories
+        Index(['b', 'c', 'd'], dtype='object')
         """
         return self.dtype.categories
 
     @property
     def ordered(self) -> Ordered:
         """
         Whether the categories have an ordered relationship.
+
+        Examples
+        --------
+        >>> ser = pd.Series(["a", "b", "c", "a"], dtype="category")
+        >>> ser.cat.ordered
+        False
+
+        >>> raw_cat = pd.Categorical(["a", "b", "c", "a"], ordered=True)
+        >>> ser = pd.Series(raw_cat)
+        >>> ser.cat.ordered
+        True
         """
         return self.dtype.ordered
 

pandas/core/strings/accessor.py

@@ -2261,6 +2261,15 @@ def translate(self, table):
         Returns
         -------
         Series or Index
+
+        Examples
+        --------
+        >>> ser = pd.Series(["El niño", "Françoise"])
+        >>> mytable = str.maketrans({'ñ': 'n', 'ç': 'c'})
+        >>> ser.str.translate(mytable)
+        0   El nino
+        1   Francoise
+        dtype: object
         """
         result = self._data.array._str_translate(table)
         return self._wrap_result(result)
@@ -2800,12 +2809,23 @@ def extractall(self, pat, flags: int = 0) -> DataFrame:
 
     Examples
     --------
+    For Series.str.find:
+
     >>> ser = pd.Series(["cow_", "duck_", "do_ve"])
     >>> ser.str.find("_")
     0   3
     1   4
     2   2
     dtype: int64
+
+    For Series.str.rfind:
+
+    >>> ser = pd.Series(["_cow_", "duck_", "do_v_e"])
+    >>> ser.str.rfind("_")
+    0   4
+    1   4
+    2   4
+    dtype: int64
     """
 
     @Appender(
@@ -2858,6 +2878,13 @@ def normalize(self, form):
         Returns
         -------
         Series/Index of objects
+
+        Examples
+        --------
+        >>> ser = pd.Series(['ñ'])
+        >>> ser.str.normalize('NFC') == ser.str.normalize('NFD')
+        0   False
+        dtype: bool
         """
         result = self._data.array._str_normalize(form)
         return self._wrap_result(result)
@@ -2892,12 +2919,23 @@ def normalize(self, form):
 
     Examples
     --------
+    For Series.str.index:
+
     >>> ser = pd.Series(["horse", "eagle", "donkey"])
     >>> ser.str.index("e")
     0   4
     1   0
     2   4
     dtype: int64
+
+    For Series.str.rindex:
+
+    >>> ser = pd.Series(["Deer", "eagle", "Sheep"])
+    >>> ser.str.rindex("e")
+    0   2
+    1   4
+    2   3
+    dtype: int64
     """
 
     @Appender(