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

@@ -1,5 +1,7 @@
 # Edit forms
 
+Note: if you haven't already you should come back here *after* you look over the [forms overview](ay-start-form-overview.md) section of this manual.
+
 AyaNova business objects are created and modified in "edit forms" and most have the same common features.
 
 ### Browser page refresh or reload

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

@@ -1,5 +1,7 @@
 # Data tables
 
+Note: if you haven't already you should come back here *after* you look over the [forms overview](ay-start-form-overview.md) section of this manual.
+
 ![example data table](img/ay-start-form-data-table-example.png)
 
 Data tables are used to view, report, or open AyaNova business objects.

docs/8.0/ayanova/docs/ay-start-form-overview.md

@@ -1,14 +1,18 @@
 # Forms
 
+AyaNova is a web application meaning that it runs inside your web browser and when you navigate to each area of AyaNova it's just like navigating to a web page.
+
+This means you can use all the standard features in your web browswer with AyaNova such as the forward and back navigation buttons, zooming in or out, saving bookmarks to any area you visit frequently etc.
+
 All areas you can navigate to in the AyaNova web application are described as "forms" in the documentation.
 
 It is our goal that, AyaNova displays and acts as similarly as possible on every supported web browser, platform and operating system.
 
-A user should have the same experience on Chrome in Linux, Safari in iOS or FireFox in Windows (for example) and we test and support each release against the most recent two releases of all major browsers at the time of release.
+A user should have the same experience on Chrome in Linux, Safari in iOS or FireFox in Windows (for example) and we support each release against the most recent two releases of all major browsers at the time of release.
 
 ### Responsive display
 
-The AyaNova interface is designed to be "responsive" which means it will adapt what is displayed to accomodate to the size of *your* device be it an iPhone, Android tablet, desktop PC or big screen TV.
+The AyaNova interface is designed to be "responsive" which means it will _adapt_ what is displayed to accomodate to the size of _your_ device be it an iPhone, Android tablet, desktop PC or big screen TV.
 
 On narrow screen devices such as smart phones and smaller tablets the form will be displayed vertically as a single column of fields:
 
@@ -28,17 +32,78 @@ The responsive display is dynamic which means it will adapt on the fly to the sc
 
 Some browsers and devices may not recognize a change of width and it may be necessary to refresh the page for the view to fully adapt in some cases. If you have to scroll a data table sideways hit refresh / reload in the browser.
 
-### Customizable labels
+#### Customizable labels
 
 Nearly all static text displayed in AyaNova is customizable via the [Translation feature](adm-translations.md)
 
 ### Main user interface components
 
-The overall AyaNova user interface consists of three main components:
+The overall AyaNova user interface consists of four main components:
 
-- [App Bar](#app-bar) at the top
-- [Navigation drawer](#navigation-drawer) to the side
-- [View](#main-view-area) displayed in the main largest area of the screen
+-   [Browser web address](#web-address) the URL or location in your web browser
+-   [App Bar](#app-bar) at the top
+-   [Navigation drawer](#navigation-drawer) to the side
+-   [View](#main-view-area) displayed in the main largest area of the screen
+
+### Web address
+
+You don't need to know about the Web address URL to use AyaNova and can skip this section if you wish but it helps to know the system behind URL's in AyaNova as they display some potentially useful information.
+
+![new empty work order](img/tour-service-labor-wo-1.png)
+
+The image above shows a new empty [work order](svc-workorders.md) being created.
+
+At the top of the image you can see the web browser's current address which always shows where you currently _are_ in AyaNova.
+
+Let's break down an example, your Host portion will be different, but the component parts are the same:
+
+`https://example.onayanova.com/svc-workorders/0`
+
+#### Host
+
+The first part of the URL shows the host server that is hosting your AyaNova instance, in our example this is the `example.onayanova.com` portion of the address.
+
+You don't need to know this to use AyaNova unless you are working on multiple different servers and want to confirm you are on the correct one. Note that some browsers may hide this part of the address but you can usually reveal it by clicking on the address bar if it's hidden and you want to see it.
+
+Depending on where your server is located this could take many forms.
+
+It could show as a network address, for example
+
+`https://192.168.1.56:7575/svc-workorders/0`
+
+or a path (after) a domain name registered to your company
+
+`https://example.com/ayanova/svc-workorders/0`
+
+or a subdomain (in front) of a domain name registered to your company
+
+`https://ayanova.example.com/svc-workorders/0`
+
+or even in multiple ways depending on whether you are accessing it from inside your office or outside your office via the internet.
+
+#### Route
+
+The second part of the address is the web application "route" or area of AyaNova being used. Generally the route is named by taking the main navigation area a dash character then the particular navigation item selected.
+
+In our example here, for service work orders the route portion is `svc-workorders` indicating that the user is in an area they got to via the "Service" section of the navigation menu and specifically the "Work orders" item.
+
+If they were creating a quote it would be `svc-quotes` instead.
+
+All routes in AyaNova use this system.
+
+#### Record id number
+
+When opening a particular record the end portion of the address will be the Ayanova generated internal ID number of the record being displayed. AyaNova assigns and uses it's own internal ID numbers for every record.
+
+For some items such as work orders that have a "Serial number" the serial number is generated separately from the internal ID number and while the Serial number and the record id may be the same (particularly at first when starting using AyaNova) they will often differ over time and represent two different things.
+
+If the user were looking at a _list_ of work orders in a data table the route would end with the `/svc-workorders` fragment indicating a list of multiple work orders, however in this case the user is creating a new work order and new records always show with id number of 0 until they are first saved and the server assigns a record ID number to them.
+
+For example, once this new work order is saved it may change to display `https://example.onayanova.com/svc-workorders/1234` indicating it has been assigned record id 1234 as that was the next available un-used internal id number for work orders.
+
+#### Bookmarks
+
+You can save a browser bookmark directly to any object in AyaNova by bookmarking the form you want to open again later because the full address is a direct link to that record.
 
 ### App bar
 
@@ -68,7 +133,7 @@ Finally, to the far right is the [context menu](#form-context-menu) which appear
 
 ![navigation drawer](img/form-navigation-drawer.png)
 
-The navigation drawer shows all the areas of AyaNova the currently logged in user has rights to access. 
+The navigation drawer shows all the areas of AyaNova the currently logged in user has rights to access.
 
 It's called a 'drawer' because is slides in and out as required to save screen space.
 
@@ -86,7 +151,7 @@ The main View area is where the currently selected data table / edit form is dis
 
 ![context menu icon](img/form-context-menu-icon.png)
 
-The context menu icon button is located in the app bar above every form in AyaNova and looks like 3 dots stacked vertically. 
+The context menu icon button is located in the app bar above every form in AyaNova and looks like 3 dots stacked vertically.
 
 When you click on the context menu icon button a context menu will open with options relevant to the particular area of AyaNova you are in.
 
@@ -98,13 +163,13 @@ On larger screens the most commonly used options will move from inside the conte
 
 While the top options in the context menu will change depending on the context, all context menus will have the following options at the bottom:
 
-- [Search](home-search.md) option for searching the AyaNova database
-- _Help_ option for viewing help about the specific form being displayed (this manual)
+-   [Search](home-search.md) option for searching the AyaNova database
+-   _Help_ option for viewing help about the specific form being displayed (this manual)
 
 Main forms that are not related to editing a single object also have the following options:
 
-- [About](ay-about.md) option for viewing version information and technical support information.
-- _View on map_ forms for objects with [address controls](ay-start-common-controls.md#address) will have a "View on map" menu item which when clicked will attempt to display the current objects location on a map provided there is enough information for the online map provider chosen to determine the location. The most accurate location is had by entering the latitude and longitude into the fields provided in the "Street" address section however most map providers can match to a postal code or street address when required.
+-   [About](ay-about.md) option for viewing version information and technical support information.
+-   _View on map_ forms for objects with [address controls](ay-start-common-controls.md#address) will have a "View on map" menu item which when clicked will attempt to display the current objects location on a map provided there is enough information for the online map provider chosen to determine the location. The most accurate location is had by entering the latitude and longitude into the fields provided in the "Street" address section however most map providers can match to a postal code or street address when required.
 
 For items that are mobile or may not have a street address such as a Customer unit in remote locations the latitude and longitude are available for location.
 

docs/8.0/ayanova/docs/tour-service-labor-wo.md

@@ -1,5 +1,7 @@
 # Simple labor only work order
 
+Note: if you haven't already you should come back here *after* you look over the [forms overview](ay-start-form-overview.md) section of this manual.
+
 In this guided tour we'll create a simple labor only work order that records the details of service and the hours to be billed.
 
 We will then print a Customer Invoice format work order report.
@@ -52,4 +54,16 @@ This list is known in AyaNova as a ["Data table"](ay-start-form-data-tables.md),
 
 ## 3\. Create a new Work order
 
-Because the currently logged in User has rights to create a work order the create work order button is available above and to the right of the list of work orders.
+Because the currently logged in User has rights to create a work order the create new record button is available above and to the right of the list of work orders:
+
+![new item button](img/tour-nav-service-manager-new-item.png)
+
+Anywhere you see this icon you can create a new record for any type of object.
+
+Click on the create new record button to open a new empty work order:
+
+![new empty work order](img/tour-service-labor-wo-1.png)
+
+In the image above we can see part of the new empty work order showing a few things that are good to know when working with _any_ record, not just work orders:
+
+### URL / address