
Knowledge your customers will love
Useful Information
By Ellis Pratt. 18 February 2003. Amended 28 February 2003.
Whilst applications are becoming more complex, many people believe that online user assistance hasn't changed much since WinHelp was introduced with Windows 3. This is a misconception. There have been many developments in this field aimed at increasing end-user productivity and satisfaction.
In this article, we have listed (in no particular order) nine of the most significant trends in online user assistance. Depending on your situation you may wish to include some or all or these into your solution.
You can also contact us if you would like a PDF version of this article.
We'd welcome your feedback on these trends, so that we can post them up to this site. Email us your thoughts. We won't reveal your identity if you don't wish us to.
Natural language search enables users to type their questions using plain English and receive a list of the most appropriate pages to answer their questions. For example, a user could type: "Where do I find information about deleting?" and receive a list of the pages that contain the relevant information.
Live online content from a Web server can be integrated with static content to enable the Help system to interact with dynamic Web-based software. For example, the Help system could include the price of the item they are trying to buy on eBay. The image below shows a screen for creating a Google advert. The embedded Help is dynamically updated to show the actual content that will be displayed on the advert you are creating.

Mass Customisation is a trend within industrial societies that is likely to affect everyone within an organisation. It is a term in vogue with Ford and others. Mass Customisation is the idea that you offer a bespoke product - A Focus with a stripy roof and a cup holder on the steering wheel – at a cheap mass production price. So we may see a day soon when you could buy MS Word with only the bits you want, plus extra bits unique to your situation. 1-1 Marketing, in effect.
So what should software vendors do to the Help system? Should they ship the Help system that is for the original, uncustomised version or build a Help system for each unique solution supplied? Or should the vendor get the customer to amend the text?
This leads to some major issues – how to do it cheaply (how to re-use, re-purpose the information) and how to make it usable.
It can be difficult to know if you are meeting the needs of your users with the online assistance you are providing. You can now analyse reports on usage patterns to help you identify information gaps and areas that could use improvement. You can use reports to answer questions such as:·
Applications can suffer from Help windows being placed in inconvenient locations—often covering the portion of the interface on which the user is working. You can embed Help into the application and make information viewable as part of the application window itself. This has the following advantages:

You can change the look of the Help system to that of your organisation's Web site or application, and provide a more cohesive and professional-looking solution. This can include creating special images for navigation buttons, custom buttons, icons, and more.

You can turn your Help system into a performance support system that provides an access point to more than one type of support information. For example, you can embed computer-based training material into a Help file and provide just-in-time training to complement the context-sensitive Help. You can use interactive tutorials and demos to demonstrate your software, train users or provide support.
The Flash file Creating custom Word paragraph style on the fly provides an example of an animated demonstration that could be used for training embedded into a Help file.
You can link the Help system to a support Web site and include commonly asked support questions and just discovered workarounds for minor software bugs within the Help system. This can improve user productivity, reduce the number of calls to support desks and improve the quality of technical support.
You can write, manage, and publish documents in a variety of output formats, all from a single source. By using concepts such as "conditional text" you can deliver multiple versions of the output from a single project – for example, an expert and beginner version of a Help system, or a different version for German and Austrian users. This means you can change the document in one place, and your changes will be contained in each output format when you next publish them.

For more information on Single sourcing, see our article: An Introduction to Single Sourcing - Part 1.
Of course, many application developers will carry on offering the same type of online documents they have always offered. However, in an increasingly competitive commercial world, more and more organisations will need to move towards a more personalised approach to their products and their documentation.
Many of these trends will affect how the software application itself is developed, and a programmer might say: "It's my job to include these capabilities!" Whilst there will be a need for the technical author and application developer to work more closely, we believe there will still be a need for the specialist user-focused skills that a technical author provides.
It is also important to select the right authoring tools and have the right processes, namely:
Email us your thoughts. We won't reveal your identity if you don't wish us to.
We have published our findings into the uptake of these trends.
Contact us if you are interested in finding out how Cherryleaf can help you.
The Managing Change website provides more information on mass customisation.

The Cherryleaf newsletter is the world's most popular monthly newsletter on technical communication. It will help you to stay up-to-date on issues facing documentation professionals.
To subscribe to this free newsletter, enter your name and email address in the form below.