switch order of docstring sections

Author: jorisvandenbossche

pandas/core/strings/accessor.py

@@ -3602,27 +3602,28 @@ def casefold(self):
     Series.str.isupper : Check whether all characters are uppercase.
     Series.str.istitle : Check whether all characters are titlecase.
 
-    Examples
-    --------
+    Notes
+    -----
     Similar to ``str.isdecimal`` but also includes special digits, like
     superscripted and subscripted digits in unicode.
 
+    The exact behavior of this method, i.e. which unicode characters are
+    considered as digits, depends on the backend used for string operations,
+    and there can be small differences.
+    For example, Python considers the ³ superscript character as a digit, but
+    not the ⅕ fraction character, while PyArrow considers both as digits. For
+    simple (ascii) decimal numbers, the behaviour is consistent.
+
+    Examples
+    --------
+
     >>> s3 = pd.Series(['23', '³', '⅕', ''])
     >>> s3.str.isdigit()
     0     True
     1     True
     2     True
     3    False
     dtype: bool
-
-    Notes
-    -----
-    The exact behavior of this method, i.e. which unicode characters are
-    considered as digits, depends on the backend used for string operations,
-    and there can be small differences.
-    For example, Python considers the ³ superscript character as a digit, but
-    not the ⅕ fraction character, while PyArrow considers both as digits. For
-    simple (ascii) decimal numbers, the behaviour is consistent.
     """
 
     _shared_docs["isspace"] = """