Align with to_excel method

Author: newinh

pandas/core/generic.py

@@ -1924,11 +1924,25 @@ def _repr_latex_(self):
     If you wish to write to more than one sheet in the workbook, it is
     necessary to specify an ExcelWriter object:
 
-    >>> writer = pd.ExcelWriter('output2.xlsx', engine='xlsxwriter')
-    >>> df1.to_excel(writer, sheet_name='Sheet1')
-    >>> df2 = df1.copy()
-    >>> df2.to_excel(writer, sheet_name='Sheet2')
-    >>> writer.save()
+    >>> with ExcelWriter('output.xlsx') as writer:
+    ...     df1.to_excel(writer, sheet_name='Sheet_name_1')
+    ...     df2.to_excel(writer, sheet_name='Sheet_name_2')
+
+    If you want to set engine that can manipulate Excel,
+    pass keyword argument named engine. Actually
+    engine is automatically chosen by file extension:
+
+    >>> df1.to_excel('output1.xlsx', engine='xlsxwriter')
+    >>> with ExcelWriter('output2.xlsx', engine='openpyxl') as writer:
+    ...     df2.to_excel(writer)
+
+    You can set date format or datetime format:
+
+    >>> with ExcelWriter('path_to_file.xlsx',
+                          date_format='YYYY-MM-DD',
+                          datetime_format='YYYY-MM-DD HH:MM:SS') as writer:
+    ...     df.to_excel(writer)
+
     """
 
     def to_json(self, path_or_buf=None, orient=None, date_format=None,

pandas/io/excel.py

@@ -824,49 +824,38 @@ class ExcelWriter(object):
 
     Notes
     -----
-    None of methods and properties are considered public.
+    None of the methods and properties are considered public.
 
     For compatibility with CSV writers, ExcelWriter serializes lists
     and dicts to strings before writing.
 
     Examples
     --------
-    Using ExcelWriter, some settings can be added.
-
-    Default usage.
+    Default usage:
 
     >>> with ExcelWriter('path_to_file.xlsx') as writer:
     ...     df.to_excel(writer)
 
-    If you want to set engine that can manipulate Excel,
-    pass keyword argument named engine. Actually
-    engine is automatically chosen by file extension.
-
-    >>> with ExcelWriter('path_to_file.xlsx', engine='openpyxl') as writer:
-    ...     df.to_excel(writer)
-
-    In order to write separate DataFrames to separate sheets
-    in a single Excel file, one can pass an ExcelWriter.
+    To write to separate sheets in a single file:
 
     >>> with ExcelWriter('path_to_file.xlsx') as writer:
     ...     df1.to_excel(writer, sheet_name='Sheet1')
     ...     df2.to_excel(writer, sheet_name='Sheet2')
 
-    You can set date format or datetime format
+    You can set date format or datetime format:
 
     >>> with ExcelWriter('path_to_file.xlsx',
                           date_format='YYYY-MM-DD',
                           datetime_format='YYYY-MM-DD HH:MM:SS') as writer:
     ...     df.to_excel(writer)
 
-    It also supports append mode.
+    You can also append to an existing Excel file:
 
     >>> with ExcelWriter('path_to_file.xlsx', mode='a') as writer:
     ...     df.to_excel(writer)
 
     .. versionadded:: 0.24.0
 
-
     Attributes
     ----------
     None