DOC: improve descriptions and linking in comparison includes

Author: afeld

doc/source/getting_started/comparison/includes/case.rst

@@ -1,4 +1,5 @@
-The equivalent Python functions are ``upper``, ``lower``, and ``title``.
+The equivalent pandas methods are :meth:`Series.str.upper`, :meth:`Series.str.lower`, and
+:meth:`Series.str.title`.
 
 .. ipython:: python
 

doc/source/getting_started/comparison/includes/find_substring.rst

@@ -1,8 +1,7 @@
-Python determines the position of a character in a string with the
-:func:`find` function. ``find`` searches for the first position of the
-substring. If the substring is found, the function returns its
-position. Keep in mind that Python indexes are zero-based and
-the function will return -1 if it fails to find the substring.
+You can find the position of a character in a column of strings with the :meth:`Series.str.find`
+method. ``find`` searches for the first position of the substring. If the substring is found, the
+method returns its position. If not found, it returns ``-1``. Keep in mind that Python indexes are
+zero-based.
 
 .. ipython:: python
 

doc/source/getting_started/comparison/includes/length.rst

@@ -1,4 +1,4 @@
-Python determines the length of a character string with the ``len`` function.
+You can find the length of a character string with :meth:`Series.str.len`.
 In Python 3, all strings are Unicode strings. ``len`` includes trailing blanks.
 Use ``len`` and ``rstrip`` to exclude trailing blanks.
 

doc/source/getting_started/comparison/includes/nth_word.rst

@@ -1,6 +1,5 @@
-Python extracts a substring from a string based on its text
-by using regular expressions. There are much more powerful
-approaches, but this just shows a simple approach.
+The simplest way to extract words in pandas is to split the strings by spaces, then reference the
+word by index. Note there are more powerful approaches should you need them.
 
 .. ipython:: python
 

doc/source/getting_started/comparison/includes/sorting.rst

@@ -1,5 +1,4 @@
-pandas objects have a :meth:`DataFrame.sort_values` method, which
-takes a list of columns to sort by.
+pandas has a :meth:`DataFrame.sort_values` method, which takes a list of columns to sort by.
 
 .. ipython:: python
 

doc/source/getting_started/comparison/includes/transform.rst

@@ -1,4 +1,4 @@
-pandas ``groupby`` provides a ``transform`` mechanism that allows these type of operations to be
+pandas provides a :ref:`groupby.transform` mechanism that allows these type of operations to be
 succinctly expressed in one operation.
 
 .. ipython:: python