Apply suggestions from code review

Co-authored-by: Athan <[email protected]>

Author: asmeurer

src/array_api_stubs/_draft/array_object.py

@@ -515,7 +515,7 @@ def __eq__(self: array, other: Union[int, float, bool, array], /) -> array:
            Element-wise results, including special cases, must equal the results returned by the equivalent element-wise function :func:`~array_api.equal`.
 
         .. note::
-           Comparisons of arrays without a corresponding promotable data type (see :ref:`type-promotion`) is undefined and thus implementation-dependent.
+           Comparison of arrays without a corresponding promotable data type (see :ref:`type-promotion`) is undefined and thus implementation-dependent.
         """
 
     def __float__(self: array, /) -> float:
@@ -604,7 +604,7 @@ def __ge__(self: array, other: Union[int, float, array], /) -> array:
            Element-wise results must equal the results returned by the equivalent element-wise function :func:`~array_api.greater_equal`.
 
         .. note::
-           Comparisons of arrays without a corresponding promotable data type (see :ref:`type-promotion`) is undefined and thus implementation-dependent.
+           Comparison of arrays without a corresponding promotable data type (see :ref:`type-promotion`) is undefined and thus implementation-dependent.
         """
 
     def __getitem__(
@@ -659,7 +659,7 @@ def __gt__(self: array, other: Union[int, float, array], /) -> array:
            Element-wise results must equal the results returned by the equivalent element-wise function :func:`~array_api.greater`.
 
         .. note::
-           Comparisons of arrays without a corresponding promotable data type (see :ref:`type-promotion`) is undefined and thus implementation-dependent.
+           Comparison of arrays without a corresponding promotable data type (see :ref:`type-promotion`) is undefined and thus implementation-dependent.
         """
 
     def __index__(self: array, /) -> int:
@@ -757,9 +757,6 @@ def __invert__(self: array, /) -> array:
 
         .. note::
            Element-wise results must equal the results returned by the equivalent element-wise function :func:`~array_api.bitwise_invert`.
-
-        .. note::
-           Comparisons of arrays without a corresponding promotable data type (see :ref:`type-promotion`) is undefined and thus implementation-dependent.
         """
 
     def __le__(self: array, other: Union[int, float, array], /) -> array:
@@ -786,7 +783,7 @@ def __le__(self: array, other: Union[int, float, array], /) -> array:
            Element-wise results must equal the results returned by the equivalent element-wise function :func:`~array_api.less_equal`.
 
         .. note::
-           Comparisons of arrays without a corresponding promotable data type (see :ref:`type-promotion`) is undefined and thus implementation-dependent.
+           Comparison of arrays without a corresponding promotable data type (see :ref:`type-promotion`) is undefined and thus implementation-dependent.
         """
 
     def __lshift__(self: array, other: Union[int, array], /) -> array:
@@ -959,7 +956,7 @@ def __ne__(self: array, other: Union[int, float, bool, array], /) -> array:
            Element-wise results, including special cases, must equal the results returned by the equivalent element-wise function :func:`~array_api.not_equal`.
 
         .. note::
-           Comparisons of arrays without a corresponding promotable data type (see :ref:`type-promotion`) is undefined and thus implementation-dependent.
+           Comparison of arrays without a corresponding promotable data type (see :ref:`type-promotion`) is undefined and thus implementation-dependent.
 
         .. versionchanged:: 2022.12
             Added complex data type support.

src/array_api_stubs/_draft/elementwise_functions.py

@@ -1119,7 +1119,7 @@ def equal(x1: array, x2: array, /) -> array:
        For discussion of complex number equality, see :ref:`complex-numbers`.
 
     .. note::
-       Comparisons of arrays without a corresponding promotable data type (see :ref:`type-promotion`) is undefined and thus implementation-dependent.
+       Comparison of arrays without a corresponding promotable data type (see :ref:`type-promotion`) is undefined and thus implementation-dependent.
 
     .. versionchanged:: 2022.12
        Added complex data type support.
@@ -1352,7 +1352,7 @@ def greater(x1: array, x2: array, /) -> array:
         an array containing the element-wise results. The returned array must have a data type of ``bool``.
 
     .. note::
-       Comparisons of arrays without a corresponding promotable data type (see :ref:`type-promotion`) is undefined and thus implementation-dependent.
+       Comparison of arrays without a corresponding promotable data type (see :ref:`type-promotion`) is undefined and thus implementation-dependent.
 
     """
 
@@ -1377,7 +1377,7 @@ def greater_equal(x1: array, x2: array, /) -> array:
         an array containing the element-wise results. The returned array must have a data type of ``bool``.
 
     .. note::
-       Comparisons of arrays without a corresponding promotable data type (see :ref:`type-promotion`) is undefined and thus implementation-dependent.
+       Comparison of arrays without a corresponding promotable data type (see :ref:`type-promotion`) is undefined and thus implementation-dependent.
     """
 
 
@@ -1575,7 +1575,7 @@ def less(x1: array, x2: array, /) -> array:
         an array containing the element-wise results. The returned array must have a data type of ``bool``.
 
     .. note::
-       Comparisons of arrays without a corresponding promotable data type (see :ref:`type-promotion`) is undefined and thus implementation-dependent.
+       Comparison of arrays without a corresponding promotable data type (see :ref:`type-promotion`) is undefined and thus implementation-dependent.
     """
 
 
@@ -1599,7 +1599,7 @@ def less_equal(x1: array, x2: array, /) -> array:
         an array containing the element-wise results. The returned array must have a data type of ``bool``.
 
     .. note::
-       Comparisons of arrays without a corresponding promotable data type (see :ref:`type-promotion`) is undefined and thus implementation-dependent.
+       Comparison of arrays without a corresponding promotable data type (see :ref:`type-promotion`) is undefined and thus implementation-dependent.
     """
 
 
@@ -2151,7 +2151,7 @@ def not_equal(x1: array, x2: array, /) -> array:
        For discussion of complex number equality, see :ref:`complex-numbers`.
 
     .. note::
-       Comparisons of arrays without a corresponding promotable data type (see :ref:`type-promotion`) is undefined and thus implementation-dependent.
+       Comparison of arrays without a corresponding promotable data type (see :ref:`type-promotion`) is undefined and thus implementation-dependent.
 
     .. versionchanged:: 2022.12
        Added complex data type support.