[TASK] List Form ViewHelper and Sub View helpers together (#111)

Until now, the form ViewHelper itself was listed at the bottom of the menu, its subviewhelpers on top within a directory. As they are used together I moved them into one location now, hiding the former form viewhelper page as orphan so it does not get regenerated.

Update of Form examples tbd I just moved them for the time beeing

Releases: main, 13.4

Co-authored-by: lina.wolf <[email protected]>

Author: github-actions[bot]

Documentation/Global/Form.rst

@@ -1,16 +1,11 @@
-..  This reStructured text file has been automatically generated, do not change.
-..  Source: https://github.com/TYPO3/typo3/blob/main/typo3/sysext/fluid/Classes/ViewHelpers/FormViewHelper.php
-
-:edit-on-github-link: https://github.com/TYPO3/typo3/edit/main/typo3/sysext/fluid/Classes/ViewHelpers/FormViewHelper.php
+:orphan:
 :navigation-title: form
 
 ..  include:: /Includes.rst.txt
 
-..  _typo3-fluid-form:
-
 ==========================
 Form ViewHelper `<f:form>`
 ==========================
 
-..  typo3:viewhelper:: form
-    :source: ../Global.json
+..  seealso::
+    See `Form ViewHelper <f:form> <https://docs.typo3.org/permalink/t3viewhelper:typo3-fluid-form>`_

Documentation/Global/Form/Index.rst

@@ -1,10 +1,46 @@
-..  This reStructured text file has been automatically generated, do not change.
+:navigation-title: form
+
 ..  include:: /Includes.rst.txt
+..  _typo3-fluid-form:
+
+==========================
+Form ViewHelper `<f:form>`
+==========================
+
+..  typo3:viewhelper:: form
+    :source: /Global.json
+    :display: tags,description,gitHubLink,arguments
+
+..  _typo3-fluid-form-example:
+
+Examples
+========
+
+A complex form with a specified encoding type
+---------------------------------------------
+
+Form with enctype set::
+
+   <f:form action=".." controller="..." package="..." enctype="multipart/form-data">...</f:form>
+
+A Form which should render a domain object
+------------------------------------------
+
+Binding a domain object to a form::
+
+   <f:form action="..." name="customer" object="{customer}">
+      <f:form.hidden property="id" />
+      <f:form.textarea property="name" />
+   </f:form>
+
+This automatically inserts the value of ``{customer.name}`` inside the
+textarea and adjusts the name of the textarea accordingly.
+
 
-====
-Form
-====
+..  _typo3-fluid-form-viewhelpers:
 
+ViewHelpers to be used within the form ViewHelper
+=================================================
 
 ..  toctree::
     :titlesonly:

Documentation/Global/Index.rst

@@ -9,6 +9,7 @@ Global (f:*)
 ..  toctree::
     :titlesonly:
     :glob:
+    :globExclude: Form
 
     */Index
     *