DOC: Enforce Numpy Docstring Validation for pandas.HDFStore.walk (#58386)

* DOC: add SA01 to HDFStore.walk

* DOC: remove SA01 of HDFStore.walk

Author: tuhinsharma121

ci/code_checks.sh

@@ -118,7 +118,6 @@ if [[ -z "$CHECK" || "$CHECK" == "docstrings" ]]; then
         -i "pandas.DatetimeTZDtype.tz SA01" \
         -i "pandas.DatetimeTZDtype.unit SA01" \
         -i "pandas.Grouper PR02" \
-        -i "pandas.HDFStore.walk SA01" \
         -i "pandas.Index PR07" \
         -i "pandas.Index.T SA01" \
         -i "pandas.Index.append PR07,RT03,SA01" \

pandas/io/pytables.py

@@ -1595,6 +1595,10 @@ def walk(self, where: str = "/") -> Iterator[tuple[str, list[str], list[str]]]:
         leaves : list
             Names (strings) of the pandas objects contained in `path`.
 
+        See Also
+        --------
+        HDFStore.info : Prints detailed information on the store.
+
         Examples
         --------
         >>> df1 = pd.DataFrame([[1, 2], [3, 4]], columns=["A", "B"])