Index: rails_plugins/templated_attribute/lib/templated_attribute_helper.rb
===================================================================
--- rails_plugins/templated_attribute/lib/templated_attribute_helper.rb (revision 19)
+++ rails_plugins/templated_attribute/lib/templated_attribute_helper.rb (revision 28)
@@ -1,5 +1,20 @@
+# This file contains the extensions to ActionView::Helpers::FormHelper:
+# +text_area_with_templating+[link:classes/ActionView/Helpers/FormHelper.html]
+# and +text_field_with_templating+[link:classes/ActionView/Helpers/FormHelper.html].
+
 module ActionView         #:nodoc:
   module Helpers          #:nodoc:
+    
+    
+    # Forms which have fields for templated attributes have the following behavior:
+    # * When the user visits the form, the field is pre-filled with a
+    #   template value (like <tt>http://</tt>) if the real value is empty or +nil+.
+    # * If the template is left unchanged, it's convert it to +nil+ before validation.
+    # * To imply that the initial value is a suggestion, the field's text color is
+    #   gray until the user makes a change. If the user's only change is to empty
+    #   the field, we should reset it to the template value and gray again on blur.
+    # * In addition to this, <tt>label</tt>-style templates blank their fields
+    #   (removing the template value) when they receive focus.
     module FormHelper