DOC: Enforce Numpy Docstring Validation for pandas.Index.names (#58563)

* DOC: add GL08 for pandas.Index.names

* DOC: remove GL08 for pandas.Index.names

* DOC: change return type to FrozenList in example

Author: tuhinsharma121

ci/code_checks.sh

@@ -82,7 +82,6 @@ if [[ -z "$CHECK" || "$CHECK" == "docstrings" ]]; then
         -i "pandas.Grouper PR02" \
         -i "pandas.Index PR07" \
         -i "pandas.Index.join PR07,RT03,SA01" \
-        -i "pandas.Index.names GL08" \
         -i "pandas.Index.ravel PR01,RT03" \
         -i "pandas.Index.str PR01,SA01" \
         -i "pandas.Interval PR02" \

pandas/core/indexes/base.py

@@ -1799,6 +1799,23 @@ def _get_default_index_names(
         return names
 
     def _get_names(self) -> FrozenList:
+        """
+        Get names on index.
+
+        See Also
+        --------
+        Index.name : Return Index or MultiIndex name.
+
+        Examples
+        --------
+        >>> idx = pd.Index([1, 2, 3], name="x")
+        >>> idx.names
+        FrozenList(['x'])
+
+        >>> idx = s = pd.Index([1, 2, 3], name=("x", "y"))
+        >>> idx.names
+        FrozenList([('x', 'y')])
+        """
         return FrozenList((self.name,))
 
     def _set_names(self, values, *, level=None) -> None: