Fix docstring timestamps#59458

[uditbaliyan]

Part of #59458

Addresses:
pandas.Timestamp

• Added missing 'See Also' sections (SA01) for the following methods:

  • combine, ctime, date, fromordinal, fromtimestamp, month_name
  • normalize, quarter, replace, timestamp, timetuple, toordinal
  • today, to_period, to_julian_date

• Documented missing parameters (PR01, PR07) for the following methods:

  • fromtimestamp: Added descriptions for ts and tz parameters.
  • to_period: Added description for freq parameter.
  • to_numpy: Added descriptions for dtype and copy parameters.
  • replace: Added descriptions for year, month, day, hour, minute, second, microsecond, nanosecond, tzinfo, fold parameters."

Removed

-i "pandas.Timestamp.combine PR01,SA01"
-i "pandas.Timestamp.ctime SA01"
-i "pandas.Timestamp.date SA01"
-i "pandas.Timestamp.fromordinal SA01"
-i "pandas.Timestamp.fromtimestamp PR01,SA01"
-i "pandas.Timestamp.month_name SA01"
-i "pandas.Timestamp.normalize SA01"
-i "pandas.Timestamp.quarter SA01"
-i "pandas.Timestamp.replace PR07,SA01"
-i "pandas.Timestamp.timestamp SA01"
-i "pandas.Timestamp.timetuple SA01"
-i "pandas.Timestamp.toordinal SA01"
-i "pandas.Timestamp.today SA01"
-i "pandas.Timestamp.to_period PR01,SA01"
-i "pandas.Timestamp.to_numpy PR01"
-i "pandas.Timestamp.to_julian_date SA01" \

from code_checks.sh

[uditbaliyan]

pandas/plotting/_matplotlib/core.py:549: error: Unused "type: ignore" comment [unused-ignore]

@final
   def _maybe_right_yaxis(self, ax: Axes, axes_num: int) -> Axes:
       if not self.on_right(axes_num):
           # secondary axes may be passed via ax kw
           return self._get_ax_layer(ax)

       if hasattr(ax, "right_ax"):
           # if it has right_ax property, ``ax`` must be left axes
           return ax.right_ax
       elif hasattr(ax, "left_ax"):
           # if it has left_ax property, ``ax`` must be right axes
           return ax
       else:
           # otherwise, create twin axes
           orig_ax, new_ax = ax, ax.twinx()
           # TODO: use Matplotlib public API when available
           new_ax._get_lines = orig_ax._get_lines  # type: ignore[attr-defined]
           # TODO #54485
           new_ax._get_patches_for_fill = (  # type: ignore[attr-defined]
               orig_ax._get_patches_for_fill  # type: ignore[attr-defined]
           )
           # TODO #54485
           orig_ax.right_ax, new_ax.left_ax = (  # type: ignore[attr-defined]
               new_ax,
               orig_ax,
           )

           if not self._has_plotted_object(orig_ax):  # no data on left y
               orig_ax.get_yaxis().set_visible(False)

           if self.logy is True or self.loglog is True:
               new_ax.set_yscale("log")
           elif self.logy == "sym" or self.loglog == "sym":
               new_ax.set_yscale("symlog")
           return new_ax  # type: ignore[return-value]  <- this Unused "type: ignore" comment  [unused-ignore]

Since mypy doesn't find any issues with the return type, the type: ignore[return-value] is redundant and can be removed.
Should i remove it or not ??

[mroeschke]

Thanks @uditbaliyan