address comments

Author: npolina4

dpnp/dpnp_array.py

@@ -1054,39 +1054,7 @@ def ravel(self, order="C"):
         """
         Return a contiguous flattened array.
 
-        For full documentation refer to :obj:`numpy.ndarray.ravel`.
-
-        Parameters
-        ----------
-        order : {'C', 'F'}, optional
-            The elements of a are read using this index order. ``C`` means to index
-            the elements in row-major, C-style order, with the last axis index
-            changing fastest, back to the first axis index changing slowest. ``F``
-            means to index the elements in column-major, Fortran-style order, with
-            the first index changing fastest, and the last index changing slowest.
-            By default, ``C`` index order is used.
-
-        Returns
-        -------
-        y : dpnp_array
-            `y` is a contiguous 1-D array of the same subtype as a, with shape (a.size,)
-
-        See Also
-        --------
-        :obj:`dpnp.reshape` : Change the shape of an array without changing its data.
-
-        Examples
-        --------
-        >>> import dpnp as np
-        >>> x = np.array([[1, 2, 3], [4, 5, 6]])
-        >>> x.ravel()
-        array([1, 2, 3, 4, 5, 6])
-
-        >>> x.reshape(-1)
-        array([1, 2, 3, 4, 5, 6])
-
-        >>> x.ravel(order='F')
-        array([1, 4, 2, 5, 3, 6])
+        For full documentation refer to :obj:`dpnp.ravel`.
 
         """
 
@@ -1131,28 +1099,7 @@ def repeat(self, repeats, axis=None):
         """
         Repeat elements of an array.
 
-        For full documentation refer to :obj:`numpy.ndarray.repeat`.
-
-        Parameters
-        ----------
-        repeat : Union[int, Tuple[int, ...]]
-            The number of repetitions for each element.
-            `repeats` is broadcasted to fit the shape of the given axis.
-        axis : Optional[int]
-            The axis along which to repeat values. The `axis` is required
-            if input array has more than one dimension.
-
-        Returns
-        -------
-        out : dpnp_array
-            Array with repeated elements.
-
-        Examples
-        --------
-        >>> import dpnp as np
-        >>> x = np.array([3])
-        >>> x.repeat(4)
-        array([3, 3, 3, 3])
+        For full documentation refer to :obj:`dpnp.repeat`.
 
         """
 

dpnp/dpnp_iface_manipulation.py

@@ -979,10 +979,10 @@ def ravel(a, order="C"):
     Parameters
     ----------
     x : {dpnp_array, usm_ndarray}
-        Input array. The elements in a are read in the order specified by order,
+        Input array. The elements in `a` are read in the order specified by order,
         and packed as a 1-D array.
     order : {'C', 'F'}, optional
-        The elements of a are read using this index order. ``C`` means to index
+        The elements of `a` are read using this index order. ``C`` means to index
         the elements in row-major, C-style order, with the last axis index
         changing fastest, back to the first axis index changing slowest. ``F``
         means to index the elements in column-major, Fortran-style order, with
@@ -991,8 +991,8 @@ def ravel(a, order="C"):
 
     Returns
     -------
-    y : dpnp_array
-        `y` is a contiguous 1-D array of the same subtype as a, with shape (a.size,)
+    out : dpnp_array
+        `out` is a contiguous 1-D array of the same subtype as `a`, with shape (a.size,)
 
     See Also
     --------
@@ -1026,17 +1026,17 @@ def repeat(a, repeats, axis=None):
     ----------
     x : {dpnp_array, usm_ndarray}
         Input array.
-    repeat : Union[int, Tuple[int, ...]]
-        The number of repetitions for each element.
-        `repeats` is broadcasted to fit the shape of the given axis.
-    axis : Optional[int]
-        The axis along which to repeat values. The `axis` is required
-        if input array has more than one dimension.
+    repeat : int or array of int
+        The number of repetitions for each element. `repeats` is broadcasted to fit
+        the shape of the given axis.
+    axis : int, optional
+        The axis along which to repeat values. By default, use the flattened input array,
+        and return a flat output array.
 
     Returns
     -------
     out : dpnp_array
-        Array with repeated elements.
+        Output array which has the same shape as `a`, except along the given axis.
 
     See Also
     --------
@@ -1049,6 +1049,17 @@ def repeat(a, repeats, axis=None):
     >>> np.repeat(x, 4)
     array([3, 3, 3, 3])
 
+    >>> x = np.array([[1,2], [3,4]])
+    >>> np.repeat(x, 2)
+    array([1, 1, 2, 2, 3, 3, 4, 4])
+    >>> np.repeat(x, 3, axis=1)
+    array([[1, 1, 1, 2, 2, 2],
+           [3, 3, 3, 4, 4, 4]])
+    >>> np.repeat(x, [1, 2], axis=0)
+    array([[1, 2],
+           [3, 4],
+           [3, 4]])
+
     """
 
     rep = repeats