docs/8.0/ayanova/docs/ay-start-common-controls.md

@@ -145,14 +145,33 @@ The duration control displays and accepts input of time spans.
 
 The email control displays and accepts email addresses.
 
-To the left of the email display is an @ icon button which, when clicked, will open the device's email application to send an email with the address populated by the contents of the email control.
+#### Emailing
 
-### Extension
+To the left of the email display is an @ icon button which, when clicked, will open the device's email application to send an email with the address populated by the contents of the email control.
 
 ### Menu
 
-(both in form Context i.e. wo items add and main form context menu at top disambiguate)
-(common menu, how it hides and displays on smalelr forms, how to pick etc)
+![menu control](img/control-menu-icon.png)
+
+AyaNova uses menus at the top of forms for options related to the entire form.
+
+Menus are also used inside forms such as the work order item context menu:
+
+![wo item menu control](img/form-wo-item-context-icon.png)
+
+Menus inside forms have options related to a _specific_ sub-section of the form or object only.
+
+#### Surfaced items
+
+In form menus on wider screened devices with more room, some commonly used menu items are "surfaced" out of the menu and beside the menu's icon, for example on this wide screen device displaying the save button in this edit form:
+
+![menu item save surfaced](img/control-menu-surfaced.png)
+
+On a narrow screen device such as a smart phone the save button reverts back to inside the menu to save space:
+
+![menu item no surfaced](img/control-menu-not-surfaced.png)
+
+![menu item no surfaced](img/control-menu-not-surfaced-expanded.png)
 
 ### Percent
 
@@ -160,7 +179,9 @@ To the left of the email display is an @ icon button which, when clicked, will o
 
 ![Phone control](img/control-phone.png)
 
-The phone control displays and accepts phone numbers.
+The phone control displays and accepts phone numbers and acts as a 'tel' link for dialing.
+
+#### Dialing
 
 To the left of the email display is a phone icon button which, when clicked, will open the device's dialer application to make a call to the number displayed.
 
@@ -176,9 +197,13 @@ When the role control is opened for selection by clicking on the drop down caret
 
 Place or remove a check in the checkbox to the left of a role to select or de-select that role.
 
-### Select list (not searchable)
+### Select
 
-(make sure consistent naming)
+The select control is a simple drop down selection list used for short lists of fixed choices.
+
+![select control view](img/control-select-view.png)
+
+![select control open](img/control-select-select.png)
 
 ### Tag
 
@@ -192,7 +217,9 @@ Place or remove a check in the checkbox to the left of a role to select or de-se
 
 ![url control](img/control-url.png)
 
-The url control displays and accepts URL addresses. Typically this would be a website but any URL can be entered here.
+The url control displays and accepts URL addresses. Typically this would be a website address but any type of URL can be entered here.
+
+#### Open URL
 
 To the left of the URL display is an open button which when clicked will send the URL to the devices operating system to be opened. If it's recognized by the device as a web site address then a browser window will open to that address. Other types of URLS will be handled according to the device's URL handler.