DOC: Update reshape docstring to clarify it returns a new array (#31440)

Rathod-shubhamm · apexneural-shubham · web-flow · commit e54990c7b497 · 2026-05-18T10:46:28.000-06:00
Co-authored-by: Apex-Shubham &lt;shubham.rathod@apexneural.com&gt;
diff --git a/doc/source/user/absolute_beginners.rst b/doc/source/user/absolute_beginners.rst
@@ -406,7 +406,7 @@ Can you reshape an array?
 
 **Yes!**
 
-Using ``arr.reshape()`` will give a new shape to an array without changing the
+Using ``arr.reshape()`` will return a reshaped array without changing the
 data. Just remember that when you use the reshape method, the array you want to
 produce needs to have the same number of elements as the original array. If you
 start with an array with 12 elements, you'll need to make sure that your new
diff --git a/numpy/_core/_add_newdocs.py b/numpy/_core/_add_newdocs.py
@@ -4749,7 +4749,7 @@ def _array_method_doc(name: str, params: str, doc: str) -> None:
     --------
     transpose : Equivalent function.
     ndarray.T : Array property returning the array transposed.
-    ndarray.reshape : Give a new shape to an array without changing its data.
+    ndarray.reshape : Return a reshaped ndarray without changing data.
 
     Examples
     --------
diff --git a/numpy/_core/fromnumeric.py b/numpy/_core/fromnumeric.py
@@ -207,7 +207,7 @@ def _reshape_dispatcher(a, /, shape, order=None, *, copy=None):
 @array_function_dispatch(_reshape_dispatcher)
 def reshape(a, /, shape, order='C', *, copy=None):
     """
-    Gives a new shape to an array without changing its data.
+    Returns a reshaped ndarray without changing data.
 
     Parameters
     ----------
diff --git a/numpy/ma/core.py b/numpy/ma/core.py
@@ -4751,7 +4751,7 @@ def ravel(self, order='C'):
 
     def reshape(self, *s, **kwargs):
         """
-        Give a new shape to the array without changing its data.
+        Returns a reshaped masked array without changing its data.
 
         Returns a masked array containing the same data, but with a new shape.
         The result is a view on the original array; if this is not possible, a
