update

Author: mevdschee

docs/index.md

@@ -104,11 +104,32 @@ In the future we will add support for other frameworks, such as bootstrap 5.
 
 ## Backend frameworks
 
+This package has been tested with the MintyPHP backend framework. It can also be used with other frameworks as this package has no dependencies at all.
 
+Although we don't recommend you to use MintyPHP Forms without a framework, it is certainly possible, see the full example.
 
 ## Full example
 
-Although we don't encourage you to use MintyPHP Forms without a framework, it is certainly possible:
+The Form object has the following data methods:
+
+- **fill**: Fill the form with an array of data (e.g. $_POST)
+- **validate**: Validate the form and add errors where needed
+- **addErrors**: Add custom errors (after validation)
+- **extract**: Extract the filled in form values
+- **render**: Output the form with or without root element
+
+These data methods are typically used on GET:
+
+- GET:
+  - fill (with default values or from database)
+  - render
+- POST: 
+  - fill (from POST data)
+  - validate
+    - on success: extract
+    - on errors: render
+
+You can see how these are used in the following full example:
 
 ```php
 <?php

docs/methods.md

@@ -1,22 +1,95 @@
 # Methods
 
+This pages contains an overview of the structural methods that you can use to build a form.
+
+All structural methods return a self-reference allowing to chain the method calls.
+
 ## Form
 
-The Form object has the following data methods:
+Is created by:
 
-- **fill**: Fill the form with an array of data (e.g. $_POST)
-- **extract**: Extract the filled in form values
-- **validate**: Validate the form and add errors where needed
-- **addErrors**: Add custom errors (after validation)
-- **render**: Output the form with or without root element
+- **form**: Create a Form
 
-And the following structure building methods:
+And has the following structure building methods:
 
 - **fieldsets**: Add multiple Fieldset elements
 - **fieldset**: Add a single Fieldset element
 - **fields**: Add multiple Field elements
 - **field**: Add a single Field element
+- **header**: Add a single Header element
+
+Instead of:
+
+    $form = E::form()->fields([...]);
+
+You can use:
+
+    $form = E::form([...]);
+
+as a shortcut.
+
+## Fieldset (optional)
+
+Is created by:
+
+- **fieldset**: Create a Fieldset
+
+And has the following structure building methods:
+
+- **legend**: Add a Legend element to the Fieldset
+- **header**: Add a single Header element
+- **fields**: Add multiple Field elements
+- **field**: Add a single Field element
+
+NB: Unless required you should use "fields", "field" and "header" on Form instead.
+
+## Field
+
+Is created by:
+
+- **field**: Create a Field
+
+And has the following structure building methods:
+
+- **label**: Set the label for the Field
+- **control**: Set the control for the Field
+- **validators**: Set the validators for the Field
+
+Instead of:
+
+    $form = E::field()->control($control)->label($label)->validators([$validator]);
+
+You can use:
+
+    $form = E::field($control,$label,[$validator]);
+
+as a shortcut.
+
+## Input
+
+Is created by:
+
+- **text**: Create a text Input
+- **password**: Create a password Input
+- **email**: Create an email Input
+- **number**: Create a number Input
+- **submit**: Create a submit Input
+
+And has the following structure building methods:
+
+- **type**: Set the type of the Input
+- **name**: Set the name of the Input
+- **value**: Set the value of the Input
+- **placeholder**: Set the placeholder of the Input
+
+Instead of:
+
+    $form = E::text()->name($name)->placeholder($placeholder);
+    $form = E::submit()->value($value);
 
-## Fieldset
+You can use:
 
+    $form = E::text($name,$placeholder);
+    $form = E::submit($value);
 
+as a shortcut.

src/Elements.php

@@ -45,8 +45,7 @@ public static function field(?Control $control = null, ?Label $label = null, arr
         return $field;
     }
 
-
-    public static function create(string $className): object
+    protected static function create(string $className): object
     {
         $class = self::$namespaces[self::$style] . $className;
         if (class_exists($class)) {

src/Field.php

@@ -137,7 +137,7 @@ public function setError(string $message): void
         if ($message) {
             if (!$this->error) {
                 /** @var Error */
-                $error = Elements::create('Error');
+                $error = Elements::error();
                 $this->error = $error;
             }
         } else if ($this->hideError) {