DOC: Fix some RT02 issues in docstrings (#50785)

* Corrected docstrings

* remove functions from code_checks.sh

* DOC Fix RT02 issues in docstrings GH49968

* DOC corrected docstring to comply with RT02

* DOC correcting RT02 errors PR50785

Author: DeaMariaLeon

ci/code_checks.sh

@@ -85,27 +85,17 @@ if [[ -z "$CHECK" || "$CHECK" == "docstrings" ]]; then
 
     MSG='Partially validate docstrings (RT02)' ; echo $MSG
     $BASE_DIR/scripts/validate_docstrings.py --format=actions --errors=RT02 --ignore_functions \
-    	    pandas.Series.align \
-	    pandas.Series.dt.total_seconds \
-	    pandas.Series.cat.rename_categories \
-	    pandas.Series.cat.reorder_categories \
-	    pandas.Series.cat.add_categories \
-	    pandas.Series.cat.remove_categories \
-	    pandas.Series.cat.remove_unused_categories \
 	    pandas.Index.all \
 	    pandas.Index.any \
 	    pandas.MultiIndex.drop \
 	    pandas.DatetimeIndex.to_pydatetime \
 	    pandas.TimedeltaIndex.to_pytimedelta \
-	    pandas.core.groupby.SeriesGroupBy.apply \
-	    pandas.core.groupby.DataFrameGroupBy.apply \
 	    pandas.io.formats.style.Styler.export \
 	    pandas.api.extensions.ExtensionArray.astype \
 	    pandas.api.extensions.ExtensionArray.dropna \
 	    pandas.api.extensions.ExtensionArray.isna \
 	    pandas.api.extensions.ExtensionArray.repeat \
-	    pandas.api.extensions.ExtensionArray.unique \
-	    pandas.DataFrame.align
+	    pandas.api.extensions.ExtensionArray.unique
     RET=$(($RET + $?)) ; echo $MSG "DONE"
 
 fi

pandas/core/arrays/timedeltas.py

@@ -726,7 +726,7 @@ def total_seconds(self) -> npt.NDArray[np.float64]:
 
         Returns
         -------
-        seconds : [ndarray, Float64Index, Series]
+        ndarray, Float64Index or Series
             When the calling object is a TimedeltaArray, the return type
             is ndarray.  When the calling object is a TimedeltaIndex,
             the return type is a Float64Index. When the calling object

pandas/core/frame.py

@@ -11018,7 +11018,7 @@ def to_period(
 
         Returns
         -------
-        DataFrame:
+        DataFrame
             The DataFrame has a PeriodIndex.
 
         Examples

pandas/core/generic.py

@@ -9123,7 +9123,7 @@ def align(
 
         Returns
         -------
-        (left, right) : ({klass}, type of other)
+        tuple of ({klass}, type of other)
             Aligned objects.
 
         Examples

pandas/core/groupby/groupby.py

@@ -174,7 +174,7 @@ class providing the base-class of operations.
 
     Returns
     -------
-    applied : Series or DataFrame
+    Series or DataFrame
 
     See Also
     --------

pandas/util/_decorators.py

@@ -228,7 +228,7 @@ def _format_argument_list(allow_args: list[str]) -> str:
 
     Returns
     -------
-    s : str
+    str
         The substring describing the argument list in best way to be
         inserted to the warning message.