fixed doc strings

Author: smartvinnetou

pandas/core/frame.py

@@ -2075,8 +2075,10 @@ def to_feather(self, path) -> None:
 
         to_feather(self, path)
 
-    @Appender(
-        """
+    @doc(
+        Series.to_markdown,
+        klass=_shared_doc_kwargs["klass"],
+        examples="""
         Examples
         --------
         >>> df = pd.DataFrame(
@@ -2087,10 +2089,8 @@ def to_feather(self, path) -> None:
         |---:|:-----------|:-----------|
         |  0 | elk        | dog        |
         |  1 | pig        | quetzal    |
-        """
+        """,
     )
-    @Substitution(klass="DataFrame")
-    @Appender(_shared_docs["to_markdown"])
     def to_markdown(
         self, buf: Optional[IO[str]] = None, mode: Optional[str] = None, **kwargs
     ) -> Optional[str]:

pandas/core/series.py

@@ -1427,7 +1427,21 @@ def to_string(
                 with open(buf, "w") as f:
                     f.write(result)
 
-    @doc(klass=_shared_doc_kwargs["klass"])
+    @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  |
+        """,
+    )
     def to_markdown(
         self, buf: Optional[IO[str]] = None, mode: Optional[str] = None, **kwargs
     ) -> Optional[str]:
@@ -1450,16 +1464,7 @@ def to_markdown(
         str
             {klass} in Markdown-friendly format.
 
-        Examples
-        --------
-        >>> s = pd.Series(["elk", "pig", "dog", "quetzal"], name="animal")
-        >>> print(s.to_markdown())
-        |    | animal   |
-        |---:|:---------|
-        |  0 | elk      |
-        |  1 | pig      |
-        |  2 | dog      |
-        |  3 | quetzal  |
+        {examples}
         """
         return self.to_frame().to_markdown(buf, mode, **kwargs)