document using field in forms

Author: intoeetive

docs/member/edit-profile.md

@@ -15,21 +15,37 @@
 
     exp:member:edit_profile
 
-Edit member profile.
+This template tag allows editing member's profile using the form that is similar to [Channel Form](channels/channel-form/overview.md)
 
 ## Parameters
 
+### `include_assets=`
+
+    include_assets="yes"
+
+Adds the Javascript and CSS that is required by custom member fields to your form. By default, these are **not** included
+
 ### `datepicker=`
 
-Include the datepicker javascript.  This should be set to ``yes`` if there is a date type member custom field in order to output the calendar.
+    datepicker="no"
 
-    datepicker="yes"
+Adds the datepicker to your date fields. Defaults to "yes".
 
-### `include_assets=`
+NOTE: **Note:** If you are manually constructing a date field, in order to apply the date picker you must include `rel="date-picker"`.
 
-Include the CSS for the custom member fields.
+### `include_css=`
 
-    include_assets="yes"
+    include_css="no"
+
+Allows you to manage the inclusion of required CSS independently from the `include_assets` parameter. Defaults to "yes".
+
+### `include_jquery=`
+
+    include_jquery="no"
+
+Includes jQuery automatically. Defaults to "yes".
+
+NOTE: **Note:** If you are using your own copy of jQuery you will need to load it **before** the form.
 
 ### `return=`
 
@@ -98,6 +114,12 @@ Member username. This is a **required** field and must be unique across the site
     <label for="username">Username</label>
     <input type="text" name="username" value="{username}" maxlength="120" size="40" />
 
+### Custom field
+
+The custom profile fields can be displayed individually by addressing them using the field's short name prefixed with `field:`:
+
+    {field:birthday}
+
 ## Custom Profile Field Variable Pair
 
 All custom fields are output inside the ``{custom_profile_fields}`` varialble tag pair.
@@ -112,20 +134,53 @@ All custom fields are output inside the ``{custom_profile_fields}`` varialble ta
             </p>
          {/custom_profile_fields}
 
-## Custom Profile Field Variables
+### Custom Profile Field Variables
 
-#### {lang:profile_field}
+These variables are available inside `{custom_profile_fields}` tag pair.
 
-Outputs the custom field's name.
+#### `{lang:profile_field}`
+#### `{field_label}`
 
-#### {lang:profile_field_description}
+Outputs the custom field's label.
+
+#### `{field_id}`
+
+Field ID
+
+#### `{field_name}`
+
+The field's short name
+
+#### `{lang:profile_field_description}`
+#### `{field_instructions}`
 
 Outputs the field's description, if any.
 
-#### {form:custom_profile_field}
+#### `{form:custom_profile_field}`
+#### `{display_field}`
 
 Shows the fully parsed custom member form field.
 
+#### `{field_data}`
+
+Saved field data for the member
+
+#### `{if field_required}`
+
+Checks whether the field is set as required
+
+#### `{text_direction}`
+
+Text direction set for field (`rtl` or `ltr`)
+
+#### `{maxlength}`
+
+Max. length set for text fields
+
+#### `{field_type}`
+
+Short name of the fieldtype used for field
+
 ## Example
 
     {exp:member:edit_profile

docs/member/registration.md

@@ -38,6 +38,34 @@ This parameter allows you to specify the primary role to assign the new member,
 
 This parameter allows you to use inline errors in your registration form. The errors can be displayed using the `{error:field_name}` tag where `field_name` would need to be replaced with the name of the field that has an error, as used to compose the form.
 
+### `include_assets=`
+
+    include_assets="yes"
+
+Adds the Javascript and CSS that is required by custom member fields to your form. By default, these are **not** included
+
+### `datepicker=`
+
+    datepicker="no"
+
+Adds the datepicker to your date fields. Defaults to "yes".
+
+NOTE: **Note:** If you are manually constructing a date field, in order to apply the date picker you must include `rel="date-picker"`.
+
+### `include_css=`
+
+    include_css="no"
+
+Allows you to manage the inclusion of required CSS independently from the `include_assets` parameter. Defaults to "yes".
+
+### `include_jquery=`
+
+    include_jquery="no"
+
+Includes jQuery automatically. Defaults to "yes".
+
+NOTE: **Note:** If you are using your own copy of jQuery you will need to load it **before** the form.
+
 ## Form Inputs
 NOTE: Be sure to include the required JavaScript and CSS to use the native [Password Validation](member/password-validation.md).
 
@@ -92,6 +120,11 @@ Please note you need to address those by ID and not name, e.g. `m_field_id_8`
     <label for="work_title">Work title</label>
     <input type="text" id="work_title" name="m_field_id_1" size="40" value="{if m_field_id_1}{m_field_id_1}{/if}" />
 
+And easier way to display the field's input is to use special tag:
+
+    <label for="work_title">Work title</label>
+    {field:work_title}
+
 Custom fields can also be output inside the ``{custom_fields}`` varialble tag pair.
 
         {custom_fields}
@@ -168,6 +201,9 @@ This will show errors with the submitted password as well as password confirm.
 
     {if error:username}{error:username}{/if}
 
+### `{field:field_name}`
+
+Displays the custom field input form for the given field (substitute `field_name` with actual field name). Note that the field must be set as "visible on registration" in order to show up.
 
 ## Example