- mega example cleanup

- added READMEs to all examples in each __init__.py and added to sphinx documentation
- added versioning example
- removed vertical/vertical.py, the dictlikes are more straightforward

2 files changed, 16 insertions, 6 deletions

diff --git a/examples/adjacency_list/__init__.py b/examples/adjacency_list/__init__.py
index e69de29bb..44f27090b 100644
--- a/examples/adjacency_list/__init__.py
+++ b/examples/adjacency_list/__init__.py
@@ -0,0 +1,16 @@
+"""
+An example of a dictionary-of-dictionaries structure mapped using
+an adjacency list model.
+
+E.g.::
+
+    node = TreeNode('rootnode')
+    node.append('node1')
+    node.append('node3')
+    session.add(node)
+    session.commit()
+
+    dump_tree(node)
+
+"""
+
diff --git a/examples/adjacency_list/adjacency_list.py b/examples/adjacency_list/adjacency_list.py
index 3bf20dc5f..cc539c054 100644
--- a/examples/adjacency_list/adjacency_list.py
+++ b/examples/adjacency_list/adjacency_list.py
@@ -1,9 +1,3 @@
-"""
-An example of a dictionary-of-dictionaries structure mapped using
-an adjacency list model
-
-"""
-
 from sqlalchemy import MetaData, Table, Column, Sequence, ForeignKey,\
                         Integer, String, create_engine