clean up rst and doc strings

Author: topper-123

doc/source/whatsnew/v1.1.0.rst

@@ -25,7 +25,7 @@ For example:
 
     In [1]: pd.Series([1, "abc", np.nan], dtype="string")
     Out[1]: ValueError: StringArray requires a sequence of strings or pandas.NA
-    In [2]: pd.Series([1,2, np.nan], dtype="Int64").astype("string")
+    In [2]: pd.Series([1, 2, np.nan], dtype="Int64").astype("string")
     Out[2]: ValueError: StringArray requires a sequence of strings or pandas.NA
 
 This meant that in order to convert arbitrary data to :class:`StringDtype`, you would often have to use ``.astype(str).astype('string')``, which was not intuitive.
@@ -36,7 +36,7 @@ This meant that in order to convert arbitrary data to :class:`StringDtype`, you
    ser = pd.Series([1, "abc", np.nan], dtype="string")
    ser
    ser[0]
-   pd.Series([1,2, np.nan], dtype="Int64").astype("string")
+   pd.Series([1, 2, np.nan], dtype="Int64").astype("string")
 
 
 .. _whatsnew_110.period_index_partial_string_slicing:

pandas/core/arrays/string_.py

@@ -104,6 +104,11 @@ class StringArray(PandasArray):
 
     .. versionadded:: 1.0.0
 
+    .. versionchanged:: 1.1.0
+
+        ``StringArray`` allow non-string input values, but will always convert the
+        values  to strings. (Before Pandas 1.1 non-string values were not allowed).
+
     .. warning::
 
        StringArray is considered experimental. The implementation and
@@ -152,13 +157,13 @@ class StringArray(PandasArray):
     ['This is', 'some text', <NA>, 'data.']
     Length: 4, dtype: string
 
-    Unlike ``object`` dtype arrays, ``StringArray`` doesn't allow non-string
-    values.
+    Like ``object`` dtype arrays instantiated with ``dtype="str"``, ``StringArray``
+    allows non-string values but will always convert the values to strings.
 
     >>> pd.array(['1', 1], dtype="string")
-    Traceback (most recent call last):
-    ...
-    ValueError: StringArray requires an object-dtype ndarray of strings.
+    <StringArray>
+    ['1', '1']
+    Length: 2, dtype: string
 
     For comparison methods, this returns a :class:`pandas.BooleanArray`