Tweak sphinx documentation, add a usage example

Author: bootc

docs/examples.rst

@@ -0,0 +1,15 @@
+Examples
+========
+
+Basic query for nodes using :mod:`pypuppetdb`::
+
+   import pypuppetdb
+   import pypuppetdbquery
+
+   pdb = pypuppetdb.connect()
+
+   pdb_ast = pypuppetdbquery.parse(
+       '(processorcount=4 or processorcount=8) and kernel=Linux')
+
+   for node in pdb.nodes(query=pdb_ast):
+       print(node)

docs/index.rst

@@ -3,20 +3,20 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Welcome to pypuppetdbquery's documentation!
-===========================================
+pypuppetdbquery documentation
+=============================
 
 Contents:
 
 .. toctree::
    :maxdepth: 3
 
    pypuppetdbquery
+   examples
 
 Indices and tables
 ==================
 
 * :ref:`genindex`
 * :ref:`modindex`
 * :ref:`search`
-