docstring update: added more examples for pandas.Series.str.split() method

Author: mananpal1997

pandas/core/strings.py

@@ -1116,9 +1116,8 @@ def str_split(arr, pat=None, n=None):
 
     Returns
     -------
-    split : Series/Index or DataFrame/MultiIndex of objects
-        Type matches caller unless ``expand=True`` (return type is DataFrame or
-        MultiIndex)
+    split : Series, Index, DataFrame or MultiIndex of objects
+        Type matches caller unless ``expand=True`` (see Notes)
 
     Notes
     -----
@@ -1129,6 +1128,9 @@ def str_split(arr, pat=None, n=None):
     - If for a certain row the number of found splits < `n`,
       append `None` for padding up to `n` if ``expand=True``
 
+    If using ``expand=True``, Series and Index callers return DataFrame and
+    MultIndex objects, respectively.
+
     Examples
     --------
     >>> s = pd.Series(["this is good text", "but this is even better"])