Diff of /Allura/allura/app.py [29dc95] .. [191db1]

  Switch to side-by-side view 

--- a/Allura/allura/app.py
+++ b/Allura/allura/app.py
@@ -46,6 +46,16 @@
         self.children = children
 
     def __getitem__(self, x):
+        """
+        Automatically expand the list of sitemap child entries with the given items.  Example:
+            SitemapEntry('HelloForge')[
+                SitemapEntry('foo')[
+                    SitemapEntry('Pages')[pages]
+                ]
+            ]
+
+        TODO: deprecate this; use a more clear method of building a tree
+        """
         if isinstance(x, (list, tuple)):
             self.children.extend(list(x))
         else: