fixed a linting error and docstrings validation

Author: smartvinnetou

pandas/core/frame.py

@@ -2187,17 +2187,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/series.py

@@ -1404,17 +1404,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
@@ -1437,8 +1440,7 @@ def to_markdown(
         -------
         str
             {klass} in Markdown-friendly format.
-        {examples}
-        """
+        {examples}"""
         return self.to_frame().to_markdown(buf, mode, **kwargs)
 
     # ----------------------------------------------------------------------