Index: doc/howto.txt
==================================================================
--- doc/howto.txt
+++ doc/howto.txt
@@ -1,5 +1,17 @@
+Gotchas!
+=======
+
+1. All items for a page *must* be part of a list!
+
+   OK:     (list (function1 param1)(function2 param2))
+   NOT OK: (begin (function1 param1)(function2 param2))
+
+
+Various components
+==================
+
 ======================================================================
 1. Create a link.
 
 (s:null "[" (s:a name 'href 
                (s:link-to (string-append "location/" (string-intersperse p "/") ""))) "] ")))