The End User (LMW)

The End User (LMW)


Light My Way - Documentation


Page Content


The End User

To consume in-app guides the web extension is used. The extension present guides recorded by the author based on the application state so that the right instruction is displayed at the right time. The consumer can choose among available guides from a panel tab at the side and guide callouts are presented just in time as the user click around in the application. The consumer will find the ‘LIGHT MY WAY’ tab at the right of the application. This tab will be used to access all guide content and control preference.

Guides

Each instruction belongs to a guide. A guide allows the consumer to enable a series of instructions in one go and is often equal to a use case, a process or a training chapter.

Toggle on/off

The consumer can toggle guides to be displayed on/off. The toggle state is persisted over time (browser local storage) and allows the user to keep his favorite guides on so that the right instruction automatically appears as the application state is right.

 

image-20240708-143403.png

Available guides

To make it easy for users to find help relevant to the current view the guides, with at least one instruction valid for the current view (contexts) is displayed on top.

By default Show Available Content Only is toggled on and only guides and documentation with at least one valid context will show up.
If the user toggles this off all guides and documentation will be listed.

The user also get aware there is help to get in case the panel tab is minimized. If there is a guide available but it is disabled a shining indication appears on the panel tab.

 

Show Available Content.gif

 

Finding guides

Users can find instruction guides by a filtering functionality. The filter field opens by clicking the search icon. Entered text will filter down the guide matching the text in labels, description and instruction content. The filter function is cancelled by pressing the arrow and any entered text is cleared by pressing the x.

 

image-20240708-143708.png

 

Description

A detailed description for each guide can be added by the author and is made available to the consumer by expanding an accordion. A good description makes the guide searchable and makes it easy for the consumer to understand what it is about and when it is made available.

 

image-20240708-143758.png

 

Color

To easily differentiate between guides the author can assign different colors. Guide colors are also displayed next to the guide name in the panel.

image-20240708-143602.png

 

Sort Guides

Users can sort guides by color, alphanumerically or “Default sorted” (the order the Author has sorted them by) by clicking the sort icon.
By default the sorting is set to “Default sorted”.

Tags View

By clicking on “Enable TagsView” the guides will be grouped by tags.
For more information about tags see “Tags” below.

 

Documentation

Users can find relevant external resources (e.g. pdf-documentation, videos etc.) by navigating to the Documentation tab.

Clicking these links will open a new tab with that link.

 

image-20240708-143852.png

 

Screenshot view

If a guide contains screenshots the guide can be viewed in screenshot view by clicking the image icon.

The steps that are active in the current context will be highlighted.

If the user clicks on an image it will be opened in a modal together with the description.

image-20251031-114657.png
image-20251031-114940.png

 

Export guides

If export guides are enabled by the administrator then the user can export the guides by clicking on the menu icon and selecting an export format.

image-20251031-115627.png

 

Instructions

The visual callout elements that guides the user are called instructions.

Just-in-time delivery

To ensure that the right instruction appear at the right time, all callouts reacts and validates as the application state change.

Instructions valid for the current view and application state automatically appears on screen. With the context that its guide is toggled active.

In case of multiple instructions appearing on top of each other. The hovered instruction would go on top.

Dismissing instructions

In case an instruction callout is in the way it can be dismissed by clicking the x. Instruction dismissal is temporary and will appear next session as long as application state and group toggle state still say it should.

If you want a dismissal to be persistent you can click the dismiss-icon. The instruction wont be shown again unless the guide is toggled off and then on again.

 

image-20240919-105834.png

 

Links

Some instructions can contain links. When a link is clicked the content will open in a new browser tab.

image-20240923-094947.png

 

Images

Instructions can contain images. When an image is clicked the image will open in a new browser tab.

image-20241004-133552.png

 

Preferences

To increase usability the consumer can control some of the behavior through preferences found at the top right corner of the panel.

image-20240923-095036.png

 

UI Preferences

Under the preferences option the user can control callout layout and styling.

image-20250515-115140.png

 

Use thick tabs

Make tabs bigger when toggled on.

Default tabs

Thick tabs

Minimized callouts

When the cursor is close to the target the callout will be minimized to not distract from the target and the action the user is about to do.

This can be toggled of in the preferences.

 

image-20240919-111350.png

 

Language

Changing language changes the language of the different actions and buttons in Light My Way.

Currently English and French is available.

 

 

Flip LMW Panel

This is used to switch side of the panel from the right to the left and vice versa.

You can also flip the panel from the browser context menu by right-clicking the page and navigating to “Light My Way“ → “Flip Panel“.

image-20240923-095144.png

 

Refresh

Reloads Light My Way with the latest data.

 

image-20240923-095232.png

 

Start Tour

Start a tour on how to use Light My Way.

This tour is automatically started on every new installation.

image-20240923-095334.png

 

Tags

Filter listed guides by tags. Toggling tags on/off can be done from the tag icon found at the top right corner. By enabling at least one tag all guides will be filtered down to only include those matching the selected tags. Tag filtering is a good way to hide the guides not of value to you and allow you to focus on the ones that are.

Tags can be used to filter instructions by role, experience level or any other label like detail level. Tags are set and maintained by the author, consumer selects the ones to filer by.

 

 

AI Help

By navigating to the AI Help tab the user can get directions and information directly based on the context of the application.

The AI will try to give as relevant information as possible but the user can reply with follow up questions to get further help.

The documentation Light My Way AI uses can be updated by the customer in collaboration with Light My Way team to include customer specific documentation.

image-20250515-131350.png

 

TECHNIA CONFIDENTIAL