docs/8.0/ayanova/docs/ay-start-edit-forms.md

@@ -1,10 +1,67 @@
 # Edit forms
 
-[Under construction]
-#b4beta
+AyaNova business objects are created and edited in edit forms.  Here we detail the common features of edit forms.  Some forms will not have these features if they don't apply, for example there won't be a "View on map" menu item if there is no address for the object being edited.
+
+### Top Application bar
+
+The top portion of an edit form ("App bar") is the primary source for navigation and commands and consists of a bar at the top:
+
+![narrow edit form appbar image](img/edit-form-appbar-green-narrow.png)
+
+This app bar is green indicating the User has the ability to edit the current record.
+
+![narrow edit form appbar gray image](img/edit-form-appbar-gray-narrow.png)
+
+This app bar is grey indicating the User is not permitted to to edit the current record.  Grey app bars can indicate an object is also in a read-only state rather than the User not having sufficient privileges.  For example when a service work order is temporarily set to a read only status.
+
+#### App bar controls
+
+![edit form appbar parts image](img/edit-form-appbar-parts.png)
+
+##### Nav icon
+
+The nav icon or "hamburger" button slides open the navigation pane to move to different main areas of AyaNova.
+
+##### Object type icon
+
+The object type icon is a visual reminder of what type of object is being edited.  All business objects in AyaNova have their own icon to represent them.
+
+##### Object name
+
+The object name is displayed at the top as a visual reminder of which exact object is being edited and also appears in the web page title so that it can be seen on desktop browsers when AyaNova is minimized such as in the Windows task bar.
+
+##### Notification icon
+
+The notification bell icon is always visible in AyaNova and indicates when there are new [notifications](home-notifications.md) that have arrived and how many.
+
+##### Surfaced menu items
+
+When there is enough width to fit, AyaNova will "surface" commonly used menu icons to save a click.  Generally this is the "Save" button on most forms.
+
+#### Menu icon
+
+Menu's that can be opened are always represented in AyaNova by the three vertical dots icon.  Menus at the top of edit forms contain controls related to the overall object.  Menus inside the edit form contain controls related to a specific sub-section of the edit form.  Look for menu controls to see further actions that can be taken in forms.
+
+### Edit form body and fields
+
+#### Responsive display
+
+AyaNova uses a grid system to automatically lay out the contents of the edit form appropriate to the width of the browser window.  
+
+In narrow view devices such as smart phones and small tablets AyaNova will display a single vertical column of all form fields.  This expands up to 4 columns wide on the widest browser windows on wide screen devices such as a typical PC monitor.
+
+#### Error and alerts
+
+![edit form alert types image](img/edit-form-alert-types.png)
+
+
+
+### Common edit form menu options
 
 #### Save
 
+The Save 
+
 #### Delete
 
 #### Report