# HG changeset patch
# User drewp@bigasterisk.com
# Date 2013-03-26 08:24:06
# Node ID 89afd38433e8c273803f22ba9b6668b678e30dda
# Parent  2bf4b72cb5e87b0fb69e099df1ac5b0a81740813

docs
Ignore-this: 84f3a0144967d1c29399862656da66a9

diff --git a/light9/rdfdb/autodepgraphapi.py b/light9/rdfdb/autodepgraphapi.py
--- a/light9/rdfdb/autodepgraphapi.py
+++ b/light9/rdfdb/autodepgraphapi.py
@@ -7,8 +7,15 @@ class AutoDepGraphApi(object):
     """
     knockoutjs-inspired API for automatically building a dependency
     tree while reading the graph. See addHandler().
+
+    This design is more aggressive than knockoutjs, since the obvious
+    query methods like value() all error if you're not in a watched
+    section of code. This is supposed to make it easier to notice
+    dependency mistakes, especially when porting old code to use
+    SyncedGraph.
     
-    mixin for SyncedGraph, separated here because these methods work together
+    This class is a mixin for SyncedGraph, separated here because
+    these methods work together
     """
 
     def __init__(self):