[Doc] Added examples to str.istitle()

Author: adorilson

Doc/library/stdtypes.rst

@@ -2151,12 +2151,27 @@ expression support in the :mod:`re` module).
    ``B``, or ``S``.
 
 
+.. _meth-str-istitle:
+
 .. method:: str.istitle()
 
    Return ``True`` if the string is a titlecased string and there is at least one
    character, for example uppercase characters may only follow uncased characters
    and lowercase characters only cased ones.  Return ``False`` otherwise.
 
+   For example:
+
+   .. doctest::
+
+      >>> 'Spam, Spam, Spam'.istitle()
+      True
+      >>> 'spam, spam, spam'.istitle()
+      False
+      >>> 'SPAM, SPAM, SPAM'.istitle()
+      False
+
+   See also :meth:`title`.
+
 
 .. method:: str.isupper()
 
@@ -2534,6 +2549,7 @@ expression support in the :mod:`re` module).
         >>> titlecase("they're bill's friends.")
         "They're Bill's Friends."
 
+   See also :meth:`istitle`.
 
 .. method:: str.translate(table, /)