DOC: fix RT03 for CategoricalIndex.set_categories, DataFrame.astype, DataFrame.at_time and DataFrame.ewm (#57605)

* Add description of returned value of astype method * Add description text to return value of at_time method. * Add description for rreturn value of DataFrame.ewm method * Remove fixed methods from validation script exclusion * Change indentation in description

Author: bergnerjonas

ci/code_checks.sh

@@ -839,10 +839,6 @@ if [[ -z "$CHECK" || "$CHECK" == "docstrings" ]]; then
 
  MSG='Partially validate docstrings (RT03)' ; echo $MSG
  $BASE_DIR/scripts/validate_docstrings.py --format=actions --errors=RT03 --ignore_functions \
- pandas.CategoricalIndex.set_categories\
- pandas.DataFrame.astype\
- pandas.DataFrame.at_time\
- pandas.DataFrame.ewm\
  pandas.DataFrame.expanding\
  pandas.DataFrame.filter\
  pandas.DataFrame.first_valid_index\

pandas/core/generic.py

@@ -6197,6 +6197,7 @@ def astype(
  Returns
  -------
  same type as caller
+ The pandas object casted to the specified ``dtype``.
 
  See Also
  --------
@@ -8675,6 +8676,7 @@ def at_time(self, time, asof: bool = False, axis: Axis | None = None) -> Self:
  Returns
  -------
  Series or DataFrame
+ The values with the specified time.
 
  Raises
  ------

pandas/core/window/ewm.py

@@ -226,6 +226,8 @@ class ExponentialMovingWindow(BaseWindow):
  Returns
  -------
  pandas.api.typing.ExponentialMovingWindow
+ An instance of ExponentialMovingWindow for further exponentially weighted (EW)
+ calculations, e.g. using the ``mean`` method.
 
  See Also
  --------