update documentation

Author: willforde

README.rst

@@ -19,10 +19,10 @@
 .. image:: https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg
     :target: https://saythanks.io/to/willforde
 
-Why another Python HTML Parser?
--------------------------------
+HTMLement
+---------
 
-There is no "HTML Parser" in the "Python" Standard Library.
+Why another Python HTML Parser? There is no "HTML Parser" in the "Python" Standard Library.
 Actually, there is the `html.parser.HTMLParser`_ that simply "traverses the DOM tree" and allows me to be notified as
 each tag is being parsed. Usually, when "parsing HTML" I want to query its elements and extract data from it.
 

docs/index.rst

@@ -3,8 +3,8 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-htmlement Module
-================
+Welcome to HTMLement's documentation!
+=====================================
 
 .. include::
     ../README.rst
@@ -18,12 +18,10 @@ API
 .. automodule:: htmlement
     :members:
 
-References
-----------
-https://docs.python.org/2/library/xml.etree.elementtree.html#element-objects
+External Links
+--------------
+ElementTree: https://docs.python.org/2/library/xml.etree.elementtree.html
 
-https://docs.python.org/2/library/xml.etree.elementtree.html#xpath-support
-
-https://github.com/willforde/python-htmlement
+Bug Tracker: https://github.com/willforde/python-htmlement/issues
 
 .. _examples.py: https://github.com/willforde/python-htmlement/blob/master/examples.py