fixed a linting error and docstrings validation

Author: smartvinnetou

pandas/core/frame.py

@@ -2095,17 +2095,20 @@ def to_feather(self, path, **kwargs) -> None:
     @doc(
         Series.to_markdown,
         klass=_shared_doc_kwargs["klass"],
-        examples="""Examples
-        --------
-        >>> df = pd.DataFrame(
-        ...     data={"animal_1": ["elk", "pig"], "animal_2": ["dog", "quetzal"]}
-        ... )
-        >>> print(df.to_markdown())
-        |    | animal_1   | animal_2   |
-        |---:|:-----------|:-----------|
-        |  0 | elk        | dog        |
-        |  1 | pig        | quetzal    |
-        """,
+        examples=dedent(
+            """
+            Examples
+            --------
+            >>> df = pd.DataFrame(
+            ...     data={"animal_1": ["elk", "pig"], "animal_2": ["dog", "quetzal"]}
+            ... )
+            >>> print(df.to_markdown())
+            |    | animal_1   | animal_2   |
+            |---:|:-----------|:-----------|
+            |  0 | elk        | dog        |
+            |  1 | pig        | quetzal    |
+            """
+        ),
     )
     def to_markdown(
         self, buf: Optional[IO[str]] = None, mode: Optional[str] = None, **kwargs

pandas/core/internals/blocks.py

@@ -8,7 +8,7 @@
 
 from pandas._libs import NaT, algos as libalgos, lib, writers
 import pandas._libs.internals as libinternals
-from pandas._libs.tslibs import Timedelta, conversion
+from pandas._libs.tslibs import conversion
 from pandas._libs.tslibs.timezones import tz_compare
 from pandas._typing import ArrayLike
 from pandas.util._validators import validate_bool_kwarg

pandas/core/series.py

@@ -1427,17 +1427,20 @@ def to_string(
 
     @doc(
         klass=_shared_doc_kwargs["klass"],
-        examples="""Examples
-        --------
-        >>> s = pd.Series(["elk", "pig", "dog", "quetzal"], name="animal")
-        >>> print(s.to_markdown())
-        |    | animal   |
-        |---:|:---------|
-        |  0 | elk      |
-        |  1 | pig      |
-        |  2 | dog      |
-        |  3 | quetzal  |
-        """,
+        examples=dedent(
+            """
+            Examples
+            --------
+            >>> s = pd.Series(["elk", "pig", "dog", "quetzal"], name="animal")
+            >>> print(s.to_markdown())
+            |    | animal   |
+            |---:|:---------|
+            |  0 | elk      |
+            |  1 | pig      |
+            |  2 | dog      |
+            |  3 | quetzal  |
+            """
+        ),
     )
     def to_markdown(
         self, buf: Optional[IO[str]] = None, mode: Optional[str] = None, **kwargs
@@ -1460,8 +1463,7 @@ def to_markdown(
         -------
         str
             {klass} in Markdown-friendly format.
-        {examples}
-        """
+        {examples}"""
         return self.to_frame().to_markdown(buf, mode, **kwargs)
 
     # ----------------------------------------------------------------------