[Checkins] SVN: bluebream/website/docs/v1.0/manual/form.rst update introduction

[Baiju M]

Log message for revision 111544:
  update introduction
  

Changed:
  U   bluebream/website/docs/v1.0/manual/form.rst

-=-
Modified: bluebream/website/docs/v1.0/manual/form.rst
===================================================================
--- bluebream/website/docs/v1.0/manual/form.rst	2010-04-28 15:43:45 UTC (rev 111543)
+++ bluebream/website/docs/v1.0/manual/form.rst	2010-04-28 15:44:35 UTC (rev 111544)
@@ -10,25 +10,29 @@
 Introduction
 ------------
 
-BlueBream provides a HTML form library called ``zope.formlib`` to
-generate forms and widgets.  There is an advanced community supported
-library called ``z3c.form``.  This chapter will describe about using
-``zope.formlib``.
+BlueBream has a HTML form library called ``zope.formlib`` to generate
+forms and widgets.  Instead of using a form library, you can create
+all form manually.  But the formlib avoids many duplication works.
+The formlib generate form for getting input data.  You can also
+create validators and responses.
 
 Forms are web components that use widgets to display and input data.
 Typically a template displays the widgets by accessing an attribute
-or method on an underlying class.  BlueBream use ``zope.formlib`` to
-create various forms.  Example form are AddForm, EditForm, Form.
+or method on an underlying class.  The form library has support for
+validating user input data.  Form library automatically convert the
+user submitted form data into Python objects.
 
-Instead of using a form library, you can create all form manually.
-But the formlib avoids many duplication works.  The formlib generate
-form for getting input data.  You can also create validators and
-responses.
+The formlib provides some base classes for creating view classes.
+The most used base classes are DisplayForm, AddForm and EditForm.
+The DisplayForm is not really a web form to submit, but a convenience
+for displaying values based on particular context/interface.
 
-The most used forms are DisplayForm, AddForm and EditForm.  The
-DisplayForm is not really a web form to submit, but a convenience for
-displaying values based on particular context/interface.
+.. note::
 
+  There is another community supported library called `z3c.form
+  <http://docs.zope.org/z3c.form>`_.  Many projects are using this
+  library, and it is very well documented.
+
 Creating an AddForm
 -------------------
 
@@ -67,6 +71,8 @@
 Creating an EditForm
 --------------------
 
+The usage of ``EditForm`` is very similar to ``AddForm``.
+
 Conclusion
 ----------