resolved comments

Author: Joeperdefloep

pandas/io/excel/_base.py

@@ -681,14 +681,14 @@ class ExcelWriter(metaclass=abc.ABCMeta):
         be parsed by ``fsspec``, e.g., starting "s3://", "gcs://".
 
         .. versionadded:: 1.2.0
-    if_sheet_exists : {'error', 'new', 'replace', 'write_to'}, default 'error'
+    if_sheet_exists : {'error', 'new', 'replace', 'overwrite_cells'}, default 'error'
         How to behave when trying to write to a sheet that already
         exists (append mode only).
 
         * error: raise a ValueError.
         * new: Create a new sheet, with a name determined by the engine.
         * replace: Delete the contents of the sheet before writing to it.
-        * write_to: Write contents to the existing sheet.
+        * overwrite_cells: Write contents to the existing sheet.
 
         .. versionadded:: 1.3.0
     engine_kwargs : dict, optional
@@ -768,16 +768,16 @@ class ExcelWriter(metaclass=abc.ABCMeta):
     >>>     df.to_excel(writer, sheet_name="Sheet1")
 
     You can also write multiple DataFrames to a single sheet. Note that the
-    `if_sheet_exists` parameter needs to be set to `write_to` if you are in
+    `if_sheet_exists` parameter needs to be set to `overwrite_cells` if you are in
     append mode:
 
     >>> with ExcelWriter("path_to_file.xlsx",
     ...     mode="a",
     ...     engine="openpyxl",
-    ...     if_sheet_exists="write_to",
+    ...     if_sheet_exists="overwrite_cells",
     ... ) as writer:
-    >>>     df.to_excel(writer, sheet_name="Sheet1")
-    >>>     df.to_excel(writer, sheet_name="Sheet1", startcol=3)
+    >>>     df1.to_excel(writer, sheet_name="Sheet1")
+    >>>     df2.to_excel(writer, sheet_name="Sheet1", startcol=3)
 
     You can store Excel file in RAM:
 
@@ -964,10 +964,10 @@ def __init__(
 
         self.mode = mode
 
-        if if_sheet_exists not in [None, "error", "new", "replace", "write_to"]:
+        if if_sheet_exists not in [None, "error", "new", "replace", "overwrite_cells"]:
             raise ValueError(
                 f"'{if_sheet_exists}' is not valid for if_sheet_exists. "
-                "Valid options are 'error', 'new', 'replace' and 'write_to'."
+                "Valid options are 'error', 'new', 'replace' and 'overwrite_cells'."
             )
         if if_sheet_exists and "r+" not in mode:
             raise ValueError("if_sheet_exists is only valid in append mode (mode='a')")

pandas/tests/io/excel/test_openpyxl.py

@@ -139,7 +139,7 @@ def test_write_append_mode(ext, mode, expected):
     [
         ("new", 2, ["apple", "banana"]),
         ("replace", 1, ["pear"]),
-        ("write_to", 1, ["pear", "banana"]),
+        ("overwrite_cells", 1, ["pear", "banana"]),
     ],
 )
 def test_if_sheet_exists_append_modes(ext, if_sheet_exists, num_sheets, expected):
@@ -171,7 +171,7 @@ def test_if_sheet_exists_append_modes(ext, if_sheet_exists, num_sheets, expected
         (
             "invalid",
             "'invalid' is not valid for if_sheet_exists. Valid options "
-            "are 'error', 'new', 'replace' and 'write_to'.",
+            "are 'error', 'new', 'replace' and 'overwrite_cells'.",
         ),
         (
             "error",