Update Drop Down

Author: ConnorLand

content/en/docs/refguide/modeling/pages/input-widgets/drop-down.md

@@ -44,71 +44,81 @@ Styling:
 
 ## 3 Properties
 
-## 4 Styling
+### 3.1 General Section{#general}
 
-### 2.1 Common Section{#common}
+#### 3.1.1 Empty Option Caption
 
-{{% snippet file="/static/_includes/refguide/common-section-link.md" %}}
+Empty option caption is the text that is shown for the empty option in the drop-down shown to the end-user. This is a translatable text. For more details, see [Language Menu](/refguide/translatable-texts/).
+
+Adding a caption for the empty option improves the user experience of your application. It also helps end-users using a screen-reader to operate the application easily.
 
-### 2.2 Data Source Section{#data-source}
+For example, the drop-down that allows the end-user to select the region allocated to a customer, where the possible values for **Region** are held in an enumeration, could have the caption `Select a region`.
+
+{{< figure src="/attachments/refguide/modeling/pages/input-widgets/drop-down/select-a-region.png" >}}
+
+### 3.2 Data Source Section{#data-source}
 
 {{% snippet file="/static/_includes/refguide/data-source-section-link.md" %}}
 
-### 2.3 Design Properties Section{#design-properties}
+### 3.3 Label Section{#label}
 
-{{% snippet file="/static/_includes/refguide/design-section-link.md" %}} 
+{{% snippet file="/static/_includes/refguide/label-section-link.md" %}}
 
-### 2.4 Editability Section{#editability}
+### 3.4 Editability Section{#editability}
 
 {{% snippet file="/static/_includes/refguide/editability-section-link.md" %}}
 
-### 2.5 Events Section{#events}
+### 3.5 Visibility Section{#visibility}
 
-#### 2.5.1 On Change{#on-change}
+{{% snippet file="/static/_includes/refguide/visibility-section-link.md" %}}
 
-The on-change property specifies an action that will be executed when leaving the widget, either by using the <kbd>Tab</kbd> key or by clicking another widget, after the value has been changed.
+### 3.6 Validation Section{#validation}
 
-{{% snippet file="/static/_includes/refguide/events-section-link.md" %}}
+{{% snippet file="/static/_includes/refguide/widget-validation-link.md" %}}
 
-#### 2.5.2 On Enter
+### 3.7 Accessibility Section{#accessibility}
 
-The on-enter property specifies an action that will be executed when the widget is entered, either by using the <kbd>Tab</kbd> key or by clicking it with the mouse.
+### 3.7.1 Aria Required
 
-{{% snippet file="/static/_includes/refguide/events-section-link.md" %}}
+In a text area widget, when **Aria required** is set to **Yes** then assistive technologies will read out the field that is required. When set to **No** then assistive technologies will not read the field out.
 
-#### 2.5.3 On Leave
+### 3.8 Common Section{#common}
 
-The on-leave property specifies an action that will be executed when leaving the widget, either by using the <kbd>Tab</kbd> key or by clicking another widget.
+{{% snippet file="/static/_includes/refguide/common-section-link.md" %}}
 
-This differs from the [On change](#on-change) property in that the event will always be triggered, even if the value has not been changed.
+### 3.9 Events Section{#events}
+
+#### 3.9.1 On Change{#on-change}
+
+The on-change property specifies an action that will be executed when leaving the widget, either by using the <kbd>Tab</kbd> key or by clicking another widget, after the value has been changed.
 
 {{% snippet file="/static/_includes/refguide/events-section-link.md" %}}
 
-### 2.6 General Section{#general}
+#### 3.9.2 On Enter
 
-#### 2.6.1 Empty Option Caption
+The on-enter property specifies an action that will be executed when the widget is entered, either by using the <kbd>Tab</kbd> key or by clicking it with the mouse.
 
-Empty option caption is the text that is shown for the empty option in the drop-down shown to the end-user. This is a translatable text. For more details, see [Language Menu](/refguide/translatable-texts/).
+{{% snippet file="/static/_includes/refguide/events-section-link.md" %}}
 
-Adding a caption for the empty option improves the user experience of your application. It also helps end-users using a screen-reader to operate the application easily.
+#### 3.9.3 On Leave
 
-For example, the drop-down that allows the end-user to select the region allocated to a customer, where the possible values for **Region** are held in an enumeration, could have the caption `Select a region`.
+The on-leave property specifies an action that will be executed when leaving the widget, either by using the <kbd>Tab</kbd> key or by clicking another widget.
 
-{{< figure src="/attachments/refguide/modeling/pages/input-widgets/drop-down/select-a-region.png" >}}
+This differs from the [On change](#on-change) property in that the event will always be triggered, even if the value has not been changed.
 
-### 2.7 Label Section{#label}
+{{% snippet file="/static/_includes/refguide/events-section-link.md" %}}
 
-{{% snippet file="/static/_includes/refguide/label-section-link.md" %}}
+## 4 Styling
 
-### 2.8 Validation Section{#validation}
+### 4.1 Design Properties Section{#design-properties}
 
-{{% snippet file="/static/_includes/refguide/widget-validation-link.md" %}}
+{{% snippet file="/static/_includes/refguide/design-section-link.md" %}} 
 
-### 2.9 Visibility Section{#visibility}
+### 4.2 Common Section{#common-styling}
 
-{{% snippet file="/static/_includes/refguide/visibility-section-link.md" %}}
+{{% snippet file="/static/_includes/refguide/common-section-link.md" %}}
 
-## 3 Read More
+## 5 Read More
 
 * [Data View](/refguide/data-view/)
 * [Attributes](/refguide/attributes/)