UI navigation info for customizable UI

Subject: UI navigation info for customizable UI
From: "Hickling, Lisa (TOR)" <lhickling -at- Express-Scripts -dot- com>
To: "Chris Orr" <got2940 -at- hotmail -dot- com>, "Techwr-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 26 Apr 2006 11:35:06 -0500

Best practice solutions are definitely the way to go unless you depend
on an approval process and/or developers to implement it. Here's an
approach in a pinch...

If labels remain static despite custom placement in the navigational

1. Provide an inventory of each functionality including the static title
that is associated with that function, in addition to your
"comprehensive UI navigation section".

2. Provide a *simple* template for Administrators/Users [whoever
customizes views and navigation] to use in documenting the menu trees
that *they* have defined.

3. Make it clear to the users that it is their [Administrator's]
responsibility to maintain documentation of the custom configuration
that *they* have selected for their specific environment.

4. Refer guiltlessly to the static title of each menu item/functionality
as you write procedures.

Although it is [y]our responsibility to tell users where to go [no pun
intended], you can effectively do so only if the application limits the

Lisa H.

-----Original Message-----
From: Chris Orr

My documentation team has a thorny problem with our product's new UI.
the new UI, users can choose how they want to view the product, and
appear in different folders and menu structures, according to the chosen

view. Additionally, users can create new views.

We do not know how to direct users to find the items mentioned in
procedures. We have tentatively decided to provide no UI navigation info
the procedures but instead provide a comprehensive UI navigation section
our Basics chapter. But we are concerned that users may find the
they need, but not go on to use them because they can't find the items
mentioned in the procedures.

Whatever solution we decide on, it must work for us in a highly dynamic
development environment, where we maintain hundreds of documents and
localize them into many different languages.

Do you have other options for providing UI navigation info that we

Chris Orr

******* Confidentiality Notice *******
ESI Canada -- Optimizing the value of drug and dental benefits

This email, its electronic document attachments, and the contents of its website linkages may contain confidential health information. This information is intended solely for use by the individual or entity to whom it is addressed. If you have received this information in error, please notify the sender immediately and arrange for the prompt destruction of the material and any accompanying attachments.

******* Avis de confidentialite *******
ESI Canada -- Optimiser la valeur des regimes d'assurance medicaments et dentaires

Ce courriel ainsi que tout document y etant joint de meme que le contenu des liens vers des sites Web peuvent reunir des renseignements confidentiels sur la sante. Cette information s'adresse uniquement a l'usager ou a l'organisation auxquels elle est destinee. Si vous avez recu ce message par erreur, veuillez en aviser l'expediteur immediatement et proceder a la suppression du document et des fichiers joints sans tarder.


WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today!. http://www.webworks.com/techwr-l

Doc-To-Help includes a one-click RoboHelp project converter. It's that easy. Watch the demo at http://www.DocToHelp.com/TechwrlList

You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.

Previous by Author: Managing Graphic formats in ePub
Next by Author: WebWorks Publisher - context senstive help question
Previous by Thread: RE: UI navigation info for customizable UI
Next by Thread: Word: can't fix strange paper size

What this post helpful? Share it with friends and colleagues:

Sponsored Ads