[forms] Initial import of the new forms documentation (WIP)

This includes stub articles for field types references.

Author: weaverryan

book/forms.rst

@@ -13,7 +13,7 @@ Book
  templating
  testing
  validation
- forms/index
+ forms
  security/index
  http_cache
  translation

book/images/forms-simple.png

@@ -16,12 +16,7 @@
  * :doc:`MongoDB </book/doctrine/mongodb-odm/index>`
 
 * :doc:`Validation </book/validation>`
-
-* **Forms**:
-
- * :doc:`Overview </book/forms/overview>` |
- * :doc:`Templates </book/forms/view>` |
- * :doc:`Form Fields </book/forms/fields>`
+* :doc:`Forms </book/forms>`
 
 * **Security**:
 

book/index.rst

@@ -204,7 +204,7 @@ objects that can then be displayed with your form:
  $this->render('BlogBundle:Author:form.html.twig', array('form' => $form));
  }
 
-For more information, see the :doc:`Forms</book/forms/overview>` chapter.
+For more information, see the :doc:`Forms</book/forms>` chapter.
 
 .. index::
  pair: Validation; Configuration
@@ -223,7 +223,6 @@ configuration:
  framework:
  validation: { enabled: true, annotations: true }
 
-
  .. code-block:: xml
 
  <!-- app/config/config.xml -->

book/map.rst.inc

@@ -0,0 +1,46 @@
+.. index::
+ single: Forms; Types Reference
+
+Form Types Reference
+====================
+
+.. toctree::
+ :maxdepth: 1
+ :hidden:
+
+ types/birthday
+ types/checkbox
+ types/choice
+ types/collection
+ types/country
+ types/csrf
+ types/date
+ types/datetime
+ types/file
+ types/form
+ types/hidden
+ types/integer
+ types/language
+ types/locale
+ types/money
+ types/number
+ types/password
+ types/percent
+ types/radio
+ types/repeated
+ types/text
+ types/textarea
+ types/time
+ types/timezone
+ types/url
+
+A form is composed of *fields*, each of which is set to a specific field
+type (e.g. a ``text`` type, ``choice`` type, etc). Symfony2 comes standard
+with a large list of types that can be used in your application.
+
+Supported Field Types
+---------------------
+
+The following field types are natively available in Symfony2:
+
+.. include:: /reference/forms/types/map.rst.inc

book/validation.rst

@@ -0,0 +1,7 @@
+.. index::
+ single: Forms; Fields; birthday
+
+``birthday`` Field Type
+=======================
+
+See :class:`Symfony\\Component\\Form\\Type\\BirthdayType`.

reference/forms/types.rst

@@ -0,0 +1,7 @@
+.. index::
+ single: Forms; Fields; checkbox
+
+``checkbox`` Field Type
+=======================
+
+See :class:`Symfony\\Component\\Form\\Type\\CheckboxType`.

reference/forms/types/birthday.rst

@@ -0,0 +1,7 @@
+.. index::
+ single: Forms; Fields; choice
+
+``choice`` Field Type
+=====================
+
+See :class:`Symfony\\Component\\Form\\Type\\ChoiceType`.

reference/forms/types/checkbox.rst

@@ -0,0 +1,7 @@
+.. index::
+ single: Forms; Fields; collection
+
+``collection`` Field Type
+=========================
+
+See :class:`Symfony\\Component\\Form\\Type\\CollectionType`.