README improvements.

Author: spookylukey

README.rst

@@ -3,10 +3,10 @@ parsy
 
 |Documentation Status| |Build Status| |Codecov| |Downloads|
 
-Parsy is an easy way to combine simple, small parsers into complex, larger
-parsers. If it means anything to you, it's a monadic parser combinator library
-for LL(infinity) grammars in the spirit of `Parsec
-<https://github.com/haskell/parsec>`_, `Parsnip
+Parsy is an easy and elegant way to parse text in Python by combining small
+parsers into complex, larger parsers. If it means anything to you, it's a
+monadic parser combinator library for LL(infinity) grammars in the spirit of
+`Parsec <https://github.com/haskell/parsec>`_, `Parsnip
 <http://parsnip-parser.sourceforge.net/>`_, and `Parsimmon
 <https://github.com/jneen/parsimmon>`_. But don't worry, it has really good
 documentation and it doesn't say things like that!
@@ -15,16 +15,20 @@ Parsy requires Python 3.6 or greater.
 
 For a good example of the kind of clear, declarative code you can create using
 parsy, see the `SQL SELECT statement example
-<https://parsy.readthedocs.io/en/latest/howto/other_examples.html#sql-select-statement-parser>`_.
+<https://parsy.readthedocs.io/en/latest/howto/other_examples.html#sql-select-statement-parser>`_
+or `JSON parser
+<https://parsy.readthedocs.io/en/latest/howto/other_examples.html#json-parser>`_.
 
 Links:
 
 - `Documentation <http://parsy.readthedocs.io/en/latest/>`_
 - `History and changelog <http://parsy.readthedocs.io/en/latest/history.html>`_
 - `PyPI <https://pypi.python.org/pypi/parsy/>`_
 
-To contribute, please create a fork and submit a pull request on GitHub,
-after checking the "contributing" section of the docs. Thanks!
+To contribute, please create a fork and submit a pull request on GitHub, after
+checking the `contributing
+<https://parsy.readthedocs.io/en/latest/contributing.html>`_ section of the
+docs. Thanks!
 
 If you like parsy and think it should be better known, you could: