CLN: Cleanup docstrings as by code_checks

Co-Authored-By: Dacops <[email protected]>

Author: diogomsmiranda

doc/source/whatsnew/v3.0.0.rst

@@ -39,6 +39,8 @@ Other enhancements
 - Users can globally disable any ``PerformanceWarning`` by setting the option ``mode.performance_warnings`` to ``False`` (:issue:`56920`)
 - :meth:`Styler.format_index_names` can now be used to format the index and column names (:issue:`48936` and :issue:`47489`)
 - :class:`.errors.DtypeWarning` improved to include column names when mixed data types are detected (:issue:`58174`)
+- :func:`DataFrame.to_excel` now supports writing notes to an excel files via :meth:`Styler.set_tooltips` (:issue:`58070`)
+- :func:`read_excel` now supports reading notes from an excel file (:issue:`58070`)
 - :meth:`DataFrame.corrwith` now accepts ``min_periods`` as optional arguments, as in :meth:`DataFrame.corr` and :meth:`Series.corr` (:issue:`9490`)
 - :meth:`DataFrame.cummin`, :meth:`DataFrame.cummax`, :meth:`DataFrame.cumprod` and :meth:`DataFrame.cumsum` methods now have a ``numeric_only`` parameter (:issue:`53072`)
 - :meth:`DataFrame.fillna` and :meth:`Series.fillna` can now accept ``value=None``; for non-object dtype the corresponding NA value will be used (:issue:`57723`)

pandas/core/generic.py

@@ -2131,7 +2131,6 @@ def _repr_data_resource_(self):
             Arbitrary keyword arguments passed to excel engine.
     """
         ),
-        extra_examples="",
     )
     def to_excel(
         self,
@@ -2263,7 +2262,6 @@ 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/excel/_base.py

@@ -281,7 +281,7 @@
 engine_kwargs : dict, optional
     Arbitrary keyword arguments passed to excel engine.
 
-notes: DataFrame, default None
+notes : DataFrame, default None
     A DataFrame to hold the notes extracted from the Excel file.
 
 Returns
@@ -369,6 +369,10 @@
 ``set_tooltips(notes)`` method of ``Styler.to_excel``, like in
 the example below:
 
+>>> df = pd.DataFrame(
+...     [[1, 100, 200], [2, 200, 300], [3, 300, 400]],
+... )  # doctest: +SKIP
+
 >>> notes = pd.DataFrame(
 ...     [["note 1", "note 2"], ["", "note 4"], ["note 5", ""]],
 ... )  # doctest: +SKIP
@@ -1788,6 +1792,8 @@ def parse(
               DataFrame.
 
             .. versionadded:: 2.0
+        notes : DataFrame, default None
+            A DataFrame to hold the notes extracted from the Excel file.
         **kwds : dict, optional
             Arbitrary keyword arguments passed to excel engine.