Fix docstring timestamps#59458
State: closed

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

Labels:
name: Docs

Comments:
pandas/plotting/_matplotlib/core.py:549: error: Unused "type: ignore" comment  [unused-ignore]
 ```python

@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 ??
Thanks @uditbaliyan