Clarify when __index__() is applicable for arrays-as-keys in indexing

honno · honno · commit 986ba2798dee · 2024-03-27T14:03:27.000Z
diff --git a/src/array_api_stubs/_draft/array_object.py b/src/array_api_stubs/_draft/array_object.py
@@ -627,7 +627,7 @@ def __getitem__(
 
 
         .. note::
-           ``key`` can only be an array if it is valid for boolean array indexing, or supports ``__index__()``.
+           ``key`` can only be an array if it is valid for boolean array indexing, or when it supports ``__index__()`` as a 0-dimensional integer array.
 
         Returns
         -------
@@ -1107,7 +1107,7 @@ def __setitem__(
 
 
         .. note::
-           ``key`` can only be an array if it is valid for boolean array indexing, or supports ``__index__()``.
+           ``key`` can only be an array if it is valid for boolean array indexing, or when it supports ``__index__()`` as a 0-dimensional integer array.
 
         .. note::
 
