--- a/README.txt	Mon Jan 10 21:33:03 2011 -0800
+++ b/README.txt	Mon Jan 10 21:42:32 2011 -0800
@@ -13,3 +13,17 @@
 And this is the time of the iceberg.  If it really is a one-off, who
 cares?  But quickly one-offs become a deployment story, and not a very
 efficient one.  
+
+Variable Conventions
+--------------------
+
+MakeItSo! provides a few variables for you.  You can include another
+file or URL using {{include(URI)}}, where URI is the file path or the
+URL (of course, internet is required to include remote resources). The
+included resource is not included.
+
+Files and URLS being interpolated also have the variable %(here)s,
+which is the parent of their resource.  Therefor, using sensible path
+conventions, a neighboring file may be (e.g.) included like
+
+{{include(here + 'foo.txt')}}