Clarify expected values in ones and ones_like when dtype is a complex number data type (#438)

Author: kgryte

spec/API_specification/array_api/creation_functions.py

@@ -273,6 +273,9 @@ def ones(shape: Union[int, Tuple[int, ...]], *, dtype: Optional[dtype] = None, d
     """
     Returns a new array having a specified ``shape`` and filled with ones.
 
+    .. note::
+       An output array having a complex floating-point data type must contain complex numbers having a real component equal to one and an imaginary component equal to zero (i.e., ``1 + 0j``).  
+
     Parameters
     ----------
     shape: Union[int, Tuple[int, ...]]
@@ -292,6 +295,9 @@ def ones_like(x: array, /, *, dtype: Optional[dtype] = None, device: Optional[de
     """
     Returns a new array filled with ones and having the same ``shape`` as an input array ``x``.
 
+    .. note::
+       An output array having a complex floating-point data type must contain complex numbers having a real component equal to one and an imaginary component equal to zero (i.e., ``1 + 0j``).  
+
     Parameters
     ----------
     x: array