From 11dd7e001b66969ef22ad9761a4d7afcafd183ba Mon Sep 17 00:00:00 2001 From: John Cardinal Date: Fri, 10 Apr 2020 00:12:58 +0000 Subject: [PATCH] --- ...rm-basics.md => ay-start-form-overview.md} | 41 +++++++++---------- docs/8.0/ayanova/docs/ay-start-login.md | 14 +++++++ docs/8.0/ayanova/docs/ay-start-navigate.md | 11 ----- docs/8.0/ayanova/docs/form-home-search.md | 2 +- docs/8.0/ayanova/mkdocs.yml | 7 ++-- 5 files changed, 39 insertions(+), 36 deletions(-) rename docs/8.0/ayanova/docs/{ay-start-form-basics.md => ay-start-form-overview.md} (52%) create mode 100644 docs/8.0/ayanova/docs/ay-start-login.md delete mode 100644 docs/8.0/ayanova/docs/ay-start-navigate.md diff --git a/docs/8.0/ayanova/docs/ay-start-form-basics.md b/docs/8.0/ayanova/docs/ay-start-form-overview.md similarity index 52% rename from docs/8.0/ayanova/docs/ay-start-form-basics.md rename to docs/8.0/ayanova/docs/ay-start-form-overview.md index 97dc866a..a14daff8 100644 --- a/docs/8.0/ayanova/docs/ay-start-form-basics.md +++ b/docs/8.0/ayanova/docs/ay-start-form-overview.md @@ -1,25 +1,27 @@ -# FORM BASICS +# USER INTERFACE ## Overview ### Responsive display + The AyaNova interface is designed to be "responsive" which means it will adapt what is displayed to accomodate to the size of the device being used. This means that on smaller screens items will be displayed in a vertical manner and on larger screens they will flow outwards horizontally to make the best use of screen space. -In addition some elements are customized to work better with the size of the device being used. For example a data grid list of records will show as a traditional horizontal grid on a larger display to take advantage of the horizontal space and on a smaller device the same list will appear as a series of vertical boxes. This avoids the need to scroll sideways on any screen size. +In addition some elements are customized to be easiser to use with specific sizes of devices. For example a data grid list of records will show as a traditional horizontal grid with columns on a larger display to take advantage of the horizontal space and on a smaller device the same list will appear as a series of vertical boxes containing each record. This avoids the need to scroll sideways on any screen size. The responsive display is dynamic which means it will adapt on the fly to the screen size even if it changes, so, for example if you rotate a narrow screen sideways the display will change to take advantage of the wider display area. - ### Main user interface components + The overall AyaNova user interface consists of three main components: + - [App Bar](#app-bar) at the top -- [Navigation drawer](#navigation-drawer) to the side +- [Navigation drawer](#navigation-drawer) to the side - [View](#main-view-area) displayed in the main largest area of the screen - ### App bar -The purpose of the app bar is to show which part of AyaNova is currently open by displaying a text title and often an icon corresponding to the form being displayed in the main view area. + +The purpose of the app bar is to show which part of AyaNova is currently open by displaying a text title and often an icon corresponding to the form being displayed in the main view area. A blue app bar indicates the current view is a main area of AyaNova and not a specific record being edited. A green app bar indicates a specific record is being edited in an edit form. @@ -27,32 +29,29 @@ A green app bar indicates a specific record is being edited in an edit form. The app bar also hosts the [context menu](#context-menu) which appears as three dots stacked on top of each other and the "hamburger" icon which looks like three horizontal bars stacked on top of each other and is used to show or hide the [navigation drawer](#navigation-drawer) ### Navigation drawer -The navigation drawer shows all the areas of AyaNova the currently logged in user has rights to access. Clicking on an item in the navigation drawer will cause that view to be displayed in the view area of AyaNova. + +The navigation drawer shows all the areas of AyaNova the currently logged in user has rights to access. Clicking on an item in the navigation drawer will cause that view to be displayed in the view area of AyaNova. The navigation drawer can be displayed or hidden by clicking on the "hamburger" icon in the app bar. On smaller screens such as smart phones the navigation drawer is by default not shown until the user clicks on the hamburger icon. On larger screens the navigation drawer is displayed by default. -### Main view area +### View area forms - In the smallest sized screens the `Navigation drawer` will by default be hidden and only slide out when the user clicks on the `hamburger` icon at the top which appears as three horizontal lines stacked on top of each other. - -On larger screens the navigation drawer will by default be visible and can be hidden by clicking on the hamburger icon at the top. +The main View area is where the currently selected form is displayed and worked with. +## Form context menu -## How to use forms in AyaNova +The context menu is located in the app bar above every form in AyaNova and looks like 3 dots stacked vertically. It is called the "context" menu because the options in it will change based on the particular form in use, the rights the currently logged in user has to make changes or the state of an object being edited. -TODO Anatomy of a form with all possible control types and common elements and how they work -This is a good page to have images on for examples -todo: tags and picklists, show how to enter a query in a picklist and how to query tags specifically -todo: common elements between all forms and menu options like record history, save, delete, help, whatever may trip people up or be confusing +On larger screens the most commonly used options will move from inside the context menu to the main app bar to save a click. -## Navigation +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: -## Context menu -The context menu is located at the top of every form in AyaNova and looks like 3 dots stacked vertically. It is called the "context" menu because the options in it will change based on the particular form in use, the rights the currently logged in user has to make changes or the state of an object being edited. - -On larger screens the most commonly used options will move from the context menu to the main too +- [Search](form-home-search.md) option for searching the AyaNova database +- Help option for viewing help about the specific form being displayed (this manual) +- [About](form-ay-about.md) option for viewing version information and technical support information. +- [Logout]() diff --git a/docs/8.0/ayanova/docs/ay-start-login.md b/docs/8.0/ayanova/docs/ay-start-login.md new file mode 100644 index 00000000..21c2d344 --- /dev/null +++ b/docs/8.0/ayanova/docs/ay-start-login.md @@ -0,0 +1,14 @@ +# LOGIN + +The login form is displayed when you first open AyaNova or log out of AyaNova. + +The password field has an option to show your password to make it easier to ensure it's type correctly. Click on the eye symbol to the right of the passowrd field to show or hide the password entry. + +AyaNova passwords and user names are case sensitive and there are no particular rules regarding passwords but longer passwords that are easier to remember without writing down are far more secure than shorter complicated ones with a mix of symbols that are hard to remember. + +If AyaNova is in trial mode for testing there will be a [trial user select list](ay-start-trial-login.md) that allows selection from many sample users with different [Roles](ay-biz-admin-roles.md) for testing purposes and have their user name and password automatically filled in for you. + +At the bottom of the login form is a link to the AyaNova website displayed as the version and copyright information for the AyaNova app. + + + diff --git a/docs/8.0/ayanova/docs/ay-start-navigate.md b/docs/8.0/ayanova/docs/ay-start-navigate.md deleted file mode 100644 index cd7369b8..00000000 --- a/docs/8.0/ayanova/docs/ay-start-navigate.md +++ /dev/null @@ -1,11 +0,0 @@ -# NAVIGATION - -## How to move around in AyaNova - -### Login - -### Navigation panel - -### Help system - -TODO could use some images here as well \ No newline at end of file diff --git a/docs/8.0/ayanova/docs/form-home-search.md b/docs/8.0/ayanova/docs/form-home-search.md index e2de9445..4a760b35 100644 --- a/docs/8.0/ayanova/docs/form-home-search.md +++ b/docs/8.0/ayanova/docs/form-home-search.md @@ -2,7 +2,7 @@ ## Overview -AyaNova has a search form available by selecting the Search option in the [context menu](ay-start-form-basics.md#context-menu) +AyaNova has a search form available by selecting the Search option in the [context menu](ay-start-form-overview.md#form-context-menu) Explain search phrase entry, stopwords etc diff --git a/docs/8.0/ayanova/mkdocs.yml b/docs/8.0/ayanova/mkdocs.yml index dd3d0557..cdc1d92d 100644 --- a/docs/8.0/ayanova/mkdocs.yml +++ b/docs/8.0/ayanova/mkdocs.yml @@ -21,9 +21,10 @@ nav: - 'Changes from AyaNova 7': 'ay-start-changes-from-v7.md' - 'Trial mode login': 'ay-start-trial-login.md' - Forms: - - Form basics: - - 'Navigation': 'ay-start-navigate.md' - - 'Form basics': 'ay-start-form-basics.md' + - Introduction: + - 'Overview': 'ay-start-form-overview.md' + - 'Login': 'ay-start-login.md' + - 'Select lists': 'ay-start-form-select-list.md' - 'Tags': 'ay-start-form-tags.md' - 'Event log': 'ay-start-event-log.md'