Address review

Author: mroeschke

doc/source/whatsnew/v1.5.0.rst

@@ -32,15 +32,16 @@ initialized with a ``pyarrow.DataType``
     ser_float = pd.Series([1.0, 2.0, None], dtype="float32[pyarrow]")
     ser_float
 
-    ser_list = pd.Series([[1, 2]], dtype=pd.ArrowDtype(pa.list_(pa.int64())))
+    list_of_int_type = pd.ArrowDtype(pa.list_(pa.int64()))
+    ser_list = pd.Series([[1, 2], [3, None]], dtype=list_of_int_type)
     ser_list
 
 Most operations are supported and have been implemented using `pyarrow compute <https://arrow.apache.org/docs/python/api/compute.html>`__ functions.
 We recommend installing the latest version of PyArrow to access the most recently implemented compute functions.
 
 .. ipython:: python
 
-    ser_list.take([0, 0])
+    ser_list.take([1, 0])
     ser_float * 5
     ser_float.mean()
     ser_float.dropna()

pandas/core/arrays/arrow/array.py

@@ -163,7 +163,7 @@ class ArrowExtensionArray(OpsMixin, ExtensionArray):
 
     Parameters
     ----------
-    values: pyarrow.Array or pyarrow.ChunkedArray
+    values : pyarrow.Array or pyarrow.ChunkedArray
 
     Returns
     -------
@@ -175,9 +175,9 @@ class ArrowExtensionArray(OpsMixin, ExtensionArray):
     Some methods may either raise an exception or raise a ``PerformanceWarning`` if an
     associated compute function is not available based on the installed version of PyArrow.
 
-    Please install the latest version of PyArrow to enable this functionality and avoid
+    Please install the latest version of PyArrow to enable the best functionality and avoid
     potential bugs in prior versions of PyArrow.
-    """  # noqa: E501
+    """  # noqa: E501 (http link too long)
 
     _data: pa.ChunkedArray
     _dtype: ArrowDtype