DOC: Showcase writing comments in Styler.to_excel() (pandas-dev#58070)

Co-authored-by: diogomsmiranda <[email protected]>

Author: Dacops

pandas/core/generic.py

@@ -2131,6 +2131,7 @@ def _repr_data_resource_(self):
             Arbitrary keyword arguments passed to excel engine.
     """
         ),
+        extra_examples="",
     )
     def to_excel(
         self,
@@ -2262,6 +2263,7 @@ def to_excel(
         automatically chosen depending on the file extension):
 
         >>> df1.to_excel("output1.xlsx", engine="xlsxwriter")  # doctest: +SKIP
+        {extra_examples}
         """
         if engine_kwargs is None:
             engine_kwargs = {}

pandas/io/formats/style.py

@@ -82,6 +82,24 @@
 
     from pandas import ExcelWriter
 
+try:
+    import matplotlib as mpl
+    import matplotlib.pyplot as plt
+
+    has_mpl = True
+except ImportError:
+    has_mpl = False
+
+import textwrap
+
+
+@contextmanager
+def _mpl(func: Callable) -> Generator[tuple[Any, Any], None, None]:
+    if has_mpl:
+        yield plt, mpl
+    else:
+        raise ImportError(f"{func.__name__} requires matplotlib.")
+
 
 ####
 # Shared Doc Strings
@@ -537,6 +555,19 @@ def set_tooltips(
         storage_options=_shared_docs["storage_options"],
         storage_options_versionadded="1.5.0",
         extra_parameters="",
+        extra_examples=textwrap.dedent(
+            """\
+        If you wish to write excel notes to the workbook, you can do so by
+        passing a DataFrame to ``set_tooltips``. This process is independent
+        from writing data to the workbook, therefore both DataFrames can have
+        different dimensions.
+
+        >>> notes = pd.DataFrame(
+        ...     [["cell 1", "cell 2"], ["cell 3", "cell 4"]],
+        ... )
+        >>> df1.style.set_tooltips(notes).to_excel("output.xlsx")  # doctest: +SKIP
+    """
+        ),
     )
     def to_excel(
         self,