trying to figure our sphinx for auto API still :)

docs/api/index.rst

@@ -1,4 +1,7 @@
-The dpkt API reference
+
+DPKT API Reference
+==================
+The dpkt API reference section is current a large work in progress, please have patience as we fill in the documentation.
 
 **Sections**
 

docs/examples.rst

@@ -1,4 +1,6 @@
 
+Current DPKG Examples
+=====================
 [@jonoberheide's](https://twitter.com/jonoberheide) old examples still
 apply:
 
@@ -11,6 +13,8 @@ apply:
 -  `dpkt Tutorial #4: AS Paths from
    MRT/BGP <https://jon.oberheide.org/blog/2009/03/25/dpkt-tutorial-4-as-paths-from-mrt-bgp/>`__
 
+Jeff Silverman Docs/Code
+========================
 `Jeff Silverman <https://github.com/jeffsilverm>`__ has some
 `code <https://github.com/jeffsilverm/dpkt_doc>`__ and
 `documentation <http://www.commercialventvac.com/dpkt.html>`__.

docs/index.rst

@@ -16,7 +16,11 @@ User's guide
 
 Examples
 ========
-.. include:: examples.rst
+
+.. toctree::
+    :maxdepth: 2
+
+    examples
 
 API reference
 =============