DOC: Enforce Numpy Docstring Validation for pandas.Series (pandas-dev#58537)

* add see also section for pandas.Series.cat

* fix docstring errors for pandas.Series.__iter__

* remove 'pandas' from see also

* Improve See Also

Co-authored-by: Matthew Roeschke <[email protected]>

* Improve See Also

---------

Co-authored-by: Matthew Roeschke <[email protected]>

Author: 2 people

ci/code_checks.sh

@@ -163,10 +163,9 @@ if [[ -z "$CHECK" || "$CHECK" == "docstrings" ]]; then
         -i "pandas.RangeIndex.start SA01" \
         -i "pandas.RangeIndex.step SA01" \
         -i "pandas.RangeIndex.stop SA01" \
-        -i "pandas.Series.__iter__ RT03,SA01" \
         -i "pandas.Series.add PR07" \
         -i "pandas.Series.case_when RT03" \
-        -i "pandas.Series.cat PR07,SA01" \
+        -i "pandas.Series.cat PR07" \
         -i "pandas.Series.cat.add_categories PR01,PR02" \
         -i "pandas.Series.cat.as_ordered PR01" \
         -i "pandas.Series.cat.as_unordered PR01" \

pandas/core/arrays/categorical.py

@@ -1310,7 +1310,7 @@ def add_categories(self, new_categories) -> Self:
         Parameters
         ----------
         new_categories : category or list-like of category
-           The new categories to be included.
+            The new categories to be included.
 
         Returns
         -------
@@ -2864,6 +2864,11 @@ class CategoricalAccessor(PandasDelegate, PandasObject, NoNewAttributesMixin):
     ----------
     data : Series or CategoricalIndex
 
+    See Also
+    --------
+    Series.dt : Accessor object for datetimelike properties of the Series values.
+    Series.sparse : Accessor for sparse matrix data types.
+
     Examples
     --------
     >>> s = pd.Series(list("abbccc")).astype("category")

pandas/core/base.py

@@ -870,6 +870,11 @@ def __iter__(self) -> Iterator:
         Returns
         -------
         iterator
+            An iterator yielding scalar values from the Series.
+
+        See Also
+        --------
+        Series.items : Lazily iterate over (index, value) tuples.
 
         Examples
         --------