Refactor docstrings in StringMethods for improved readability and clarity

Author: Pedro-Santos04

pandas/_libs/tslibs/offsets.pyx

@@ -5108,8 +5108,8 @@ def _warn_about_deprecated_aliases(name: str, is_period: bool) -> str:
         warnings.warn(
             f"\'{name}\' is deprecated and will be removed "
             f"in a future version, please use "
-            f"\'{c_PERIOD_AND_OFFSET_DEPR_FREQSTR.get(name)}\'"
-            f" instead.",
+            f"\'{c_PERIOD_AND_OFFSET_DEPR_FREQSTR.get(name)}\' "
+            f"instead.",
             FutureWarning,
             stacklevel=find_stack_level(),
             )
@@ -5122,8 +5122,8 @@ def _warn_about_deprecated_aliases(name: str, is_period: bool) -> str:
             warnings.warn(
                 f"\'{name}\' is deprecated and will be removed "
                 f"in a future version, please use "
-                f"\'{_name}\'"
-                f" instead.",
+                f"\'{_name}\' "
+                f"instead.",
                 FutureWarning,
                 stacklevel=find_stack_level(),
                 )

pandas/core/strings/accessor.py

@@ -1431,8 +1431,10 @@ def fullmatch(self, pat, case: bool = True, flags: int = 0, na=lib.no_default):
         Determine if each string entirely matches a regular expression.
 
         Checks if each string in the Series or Index fully matches the
-        specified regular expression pattern. This function is useful when the
-        requirement is for an entire string to conform to a pattern, such as
+        specified regular expression pattern.
+        This function is useful when the
+        requirement is for an entire string to conform
+        to a pattern, such as
         validating formats like phone numbers or email addresses.
 
         Parameters
@@ -1458,21 +1460,23 @@ def fullmatch(self, pat, case: bool = True, flags: int = 0, na=lib.no_default):
 
         See Also
         --------
-        match : Similar, but also returns `True` when only a *prefix* of the string
+        match : Similar, but also returns `True`
+        when only a *prefix* of the string
             matches the regular expression.
         extract : Extract matched groups.
 
         Notes
         -----
         This method enforces consistent behavior between Python's string dtype
         and PyArrow-backed string arrays when using regular expressions
-        containing alternation (|). For regex patterns with alternation operators,
-        the method ensures proper grouping by wrapping the pattern in parentheses
+        containing alternation (|). For regex
+        patterns with alternation operators,
+        the method ensures proper grouping by
+        wrapping the pattern in parentheses
         when using PyArrow-backed string arrays.
 
         Examples
         --------
-        >>> import pandas as pd
         >>> s = pd.Series(["foo", "bar", "foobar", ""])
         >>> s.str.fullmatch("foo")
         0     True
@@ -2675,7 +2679,7 @@ def translate(self, table):
 
     @forbid_nonstring_types(["bytes"])
     def count(self, pat, flags: int = 0):
-        r"""
+        """
         Count occurrences of pattern in each string of the Series/Index.
 
         This function is used to count the number of times a particular regex