Incorporated comments

Author: ryankarlos

pandas/core/frame.py

@@ -1846,18 +1846,15 @@ def to_stata(self, fname, convert_dates=None, write_index=True,
                  data_label=None, variable_labels=None, version=114,
                  convert_strl=None):
         """
-        Converting data frame object to Stata dta format.
+        Converting DataFrame object to Stata dta format.
 
-        Writes the Dataframe to a Stata dataset file.
+        Writes the DataFrame to a Stata dataset file.
         "dta" files contain a Stata dataset.
 
         Parameters
         ----------
-        fname : path (string), buffer or path object
-            String, path object (pathlib.Path or py._path.local.LocalPath) or
-            object implementing a binary write() functions. If using a buffer
-            then the buffer will not be automatically closed after the file
-            data has been written.
+        fname : str, file descriptor or pathlib.Path
+            String or path to file which needs to be converted.
         convert_dates : dict
             Dictionary mapping columns containing datetime types to stata
             internal format to use when writing the dates. Options are 'tc',
@@ -1899,10 +1896,6 @@ def to_stata(self, fname, convert_dates=None, write_index=True,
 
             .. versionadded:: 0.23.0
 
-        Returns
-        ------
-        Stata (dta) file or StataWriter.
-
         Raises
         ------
         NotImplementedError
@@ -1924,22 +1917,12 @@ def to_stata(self, fname, convert_dates=None, write_index=True,
 
         Examples
         --------
-        Converting dataframe with date column to Stata dta file
-        using the to_stata method.
+        Converting DataFrame to Stata "dta" file using the to_stata method.
 
-        >>> dates = pd.date_range(start='2018-01-01', periods=4)
-        >>> df = pd.DataFrame({'date': dates,
-        ...                    'animal': ['falcon', 'parrot', 'falcon',
+        >>> df = pd.DataFrame({'animal': ['falcon', 'parrot', 'falcon',
         ...                               'parrot'],
-        ...                    'speed': [350, 18, 361, 15]}).set_index(['date',
-        ...                                                    'animal'])
+        ...                    'speed': [350, 18, 361, 15]})
         >>> df.to_stata('animals.dta')
-
-        Alternatively you can create an instance of the StataWriter class
-
-        >>> StataWriter = pd.io.stata.StataWriter
-        >>> writer = StataWriter('animals.dta', df)
-        >>> writer.write_file()
         """
         kwargs = {}
         if version not in (114, 117):