docs/8.0/ayanova/docs/ay-start-form-data-tables.md

@@ -10,7 +10,7 @@ Most data tables in AyaNova share the same common menu options. One ore more of
 
 This menu option opens a list of [reports](ay-report.md) available to be rendered from this data list.
 
-[Filtering](#filtering-data) affects which records will be rendered in reports; what is available in the data table is what is sent to the report rendering engine. So, for example, if you filter for only work orders from the current week that is what will be reflected in the report.
+[Filtering](#filtering-columns) affects which records will be rendered in reports; what is available in the data table is what is sent to the report rendering engine. So, for example, if you filter for only work orders from the current week that is what will be reflected in the report.
 
 Individual records can be selected for reporting by checking the checkboxes in the leftmost column when available in which case only the records selected will be sent to the report rendering engine.
 
@@ -26,7 +26,7 @@ This menu item shows the name of the last report rendered in this form to save t
 
 The Extensions menu item works with data selected similarly to how reporting works:
 
-[Filtering](#filtering-data) affects which records will be sent to the extension for processing; what is available in the data table is what is sent to the extension.
+[Filtering](#filtering-columns) affects which records will be sent to the extension for processing; what is available in the data table is what is sent to the extension.
 
 So, for example, if you filter to a specific sub-set of records only those records will be processed by the extension.
 
@@ -44,7 +44,7 @@ The help menyu item will open a specific help document from the manual related t
 
 About menu option will open the [About form](ay-about.md) which displays the version information and other information and links helpful for technical support and diagnostic / troubleshooting purposes.
 
-## Header
+## Table header
 
 ![data table header](img/form-data-table-header.png)
 
@@ -67,7 +67,7 @@ You can also select the `-` none option from the saved filter pick list to remov
 
 ##### Saving filters
 
-[Create / edit filters](#filtering-data) then click on the edit icon to the left of the saved filter selection list to open the saved filter editor.
+[Create / edit filters](#filtering-columns) then click on the edit icon to the left of the saved filter selection list to open the saved filter editor.
 
 ![data table saved filter dialog](img/form-data-table-saved-filter-dialog.png)
 
@@ -107,21 +107,39 @@ If a saved filter is selected and one or more of the columns being filtered are
 
 In this example the [column selector](#column-selector) is highlighted because there is a filter applied to the `Head Office` column which is not set to display.
 
-It is not necessary to display a hidden column, this highlighting is to indicate to the user that one ore more columns are being filtered that are not visible.
+It is not necessary to display a hidden column, this highlighting is to indicate to the user that one or more hidden columns are being filtered.
 
 ## Column headers
 
 ![data table columns header](img/form-data-table-columns-header.png)
 
-todo: fill in here how to use column headers and integrate infor belo0w in a #### level titles
+Column headers not only display the name of that column but also provide controls to [filter](filtering-columns) and [sort](sorting-columns) the columns.
 
-00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+Column header names are designed to wrap around in cases where they would not all fit horizontally to ensure as much data as possible can be displayed on all screen sizes.
 
-elements of the data table
+#### Checkbox record selection column
 
-filtering
+In most tables the leftmost column consists of checkboxes for selecting individual records. The checkbox selection column header can be used to select or deselect all visible records in the display.
 
-### Filtering data
+Note that this **selects** _visible_ records only so if you are viewing 10 records at a time but there are 100 only the 10 visible records will be selected. However it **de-selects** _all_ previously selected records regardless of whether they are visible or not.
+
+This is by design to allow a user to make selecting subsets of records easier but clearing all selections easy as well.
+
+#### Sorting columns
+
+Columns are sorted by clicking on their names to toggle their sort mode betwen ascending, descending or unsorted.  The column headers will display an arrow indicating the sort direction and a number indicating the order they were selected which affects the data returned:
+
+![data table sort](img/form-data-table-sort.png)
+
+In this example it can be seen that the data has been sorted by the Customer Name column *first* in *ascending* order indicated by the number 1 beside a downward pointing arrow sort indicator.
+
+It is sorted by the work order column *secondarily* in *descending* order indicated by the number 2 beside an upward pointing arrow sort indicator.  
+
+This results in a list ordered by customer name first from a to z then by work order number from highest to lowest.
+
+To remove a sort click on the column header name until the sort arrow indicator disappears.
+
+#### Filtering columns
 
 ### Filtering dates