docstring arg order

Author: jbrockmendel

pandas/_libs/tslibs/timestamps.pyx

@@ -1804,22 +1804,22 @@ class Timestamp(_Timestamp):
         Value of nanosecond.
     tz : str, zoneinfo.ZoneInfo, pytz.timezone, dateutil.tz.tzfile or None
         Time zone for time which Timestamp will have.
-    input_unit : str
-        Unit used for conversion if ts_input is of type int or float. The
-        valid values are 'W', 'D', 'h', 'm', 's', 'ms', 'us', and 'ns'. For
-        example, 's' means seconds and 'ms' means milliseconds.
+    unit : str or None, default None
+        Use input_unit instead.
 
-        For float inputs, the result will be stored in nanoseconds, and
-        the unit attribute will be set as ``'ns'``.
+        .. deprecated:: 3.0.0
     fold : {0, 1}, default None, keyword-only
         Due to daylight saving time, one wall clock time can occur twice
         when shifting from summer to winter time; fold describes whether the
         datetime-like corresponds  to the first (0) or the second time (1)
         the wall clock hits the ambiguous time.
-    unit : str or None, default None
-        Use input_unit instead.
+    input_unit : str
+        Unit used for conversion if ts_input is of type int or float. The
+        valid values are 'W', 'D', 'h', 'm', 's', 'ms', 'us', and 'ns'. For
+        example, 's' means seconds and 'ms' means milliseconds.
 
-        .. deprecated:: 3.0.0
+        For float inputs, the result will be stored in nanoseconds, and
+        the unit attribute will be set as ``'ns'``.
 
     See Also
     --------

pandas/core/tools/datetimes.py

@@ -772,11 +772,10 @@ def to_datetime(
           string.
 
         Cannot be used alongside ``format='ISO8601'`` or ``format='mixed'``.
-    input_unit : str, default 'ns'
-        The unit of the arg (D,s,ms,us,ns) denote the unit, which is an
-        integer or float number. This will be based off the origin.
-        Example, with ``unit='ms'`` and ``origin='unix'``, this would calculate
-        the number of milliseconds to the unix epoch start.
+    unit : str or None, default None
+        Use input_unit instead.
+
+        .. deprecated:: 3.0.0
     origin : scalar, default 'unix'
         Define the reference date. The numeric values would be parsed as number
         of units (defined by `unit`) since this reference date.
@@ -796,10 +795,11 @@ def to_datetime(
         is only used when there are at least 50 values. The presence of
         out-of-bounds values will render the cache unusable and may slow down
         parsing.
-    unit : str or None, default None
-        Use input_unit instead.
-
-        .. deprecated:: 3.0.0
+    input_unit : str, default 'ns'
+        The unit of the arg (D,s,ms,us,ns) denote the unit, which is an
+        integer or float number. This will be based off the origin.
+        Example, with ``unit='ms'`` and ``origin='unix'``, this would calculate
+        the number of milliseconds to the unix epoch start.
 
     Returns
     -------

pandas/core/tools/timedeltas.py

@@ -117,6 +117,14 @@ def to_timedelta(
             Strings with units 'M', 'Y' and 'y' do not represent
             unambiguous timedelta values and will raise an exception.
 
+    unit : str or None, default None
+        Use input_unit instead.
+
+        .. deprecated:: 3.0.0
+
+    errors : {'raise', 'coerce'}, default 'raise'
+        - If 'raise', then invalid parsing will raise an exception.
+        - If 'coerce', then invalid parsing will be set as NaT.
     input_unit : str, optional
         Denotes the unit of the arg for numeric `arg`. Defaults to ``"ns"``.
 
@@ -137,14 +145,6 @@ def to_timedelta(
             Units 'H'and 'S' are deprecated and will be removed
             in a future version. Please use 'h' and 's'.
 
-    errors : {'raise', 'coerce'}, default 'raise'
-        - If 'raise', then invalid parsing will raise an exception.
-        - If 'coerce', then invalid parsing will be set as NaT.
-    unit : str or None, default None
-        Use input_unit instead.
-
-        .. deprecated:: 3.0.0
-
     Returns
     -------
     timedelta