It’s the Eighties All Over Again: Help Strategies for Touch-Enabled Devices
|
Ken Schatzke (Webmaster) 20 March 2009 |
Categories: | • Tools of the Trade • Trends |
| Comments: | 3 |
Twenty-five years ago, Apple introduced the first Macintosh computer to the world. The two main features of the Mac were the graphical user interface and the mouse. While Apple didn’t invent these technologies, it was the first company to combine them in what we would now call an integrated user experience. During the remainder of the 1980s and the first half of the 1990s, other companies followed Apple’s lead.
Today it’s hard to imagine a personal computer without a mouse or similar pointing device. However, there was a period of time when developers—and tech writers—couldn’t safely assume their users would have access to a mouse or would know how to use it.
We are beginning to enter a similar period of time for touch-enabled devices. (See my last post for an introduction to these devices.) Though touch-enabled devices are becoming more prevalent, they are far from ubiquitous.
To help you write documentation for touch-enabled devices, I’ve compiled the following list of strategies. Most of these strategies work for both touch-based interaction and more traditional mouse-and-keyboard interaction.
- If your product utilizes gestures or other complex interactions, include videos or still photos of these interactions in an introductory section of your help or manual.
- If your product works with both touch and mouse-and-keyboard interfaces, describe how to complete basic tasks with both interfaces (for example, zooming or right-clicking).
- Choose your verbs carefully. “Press” is a good alternative to “click” and works for both touch and mouse-and-keyboard interfaces.
- Ensure buttons and links in help are large enough for users to press with their fingers. If possible, prototype the help on the touch-enabled device itself.
- Make your help and other online documentation as easy as possible to navigate without a keyboard. For example, include an index of keywords that users can scroll through in addition to a text-driven search feature.
- While the tri-pane help window has become a standard, you may need to forgo it for touch-enabled devices such as smart phones with limited screen real estate.
- If you use tool tips or other embedded help features that require hovering, develop alternative techniques for touch-enabled devices.
- Image maps can be very effective with touch-enabled interfaces and are an interesting alternative to TOCs for help navigation. For example, you could include a process diagram on the help’s home page and allow users to drill down to a specific step in the process to view the relevant help topic.
- If you have access to development resources, consider incorporating touch features in your help and other online documentation. For example, you could allow users to annotate help topics in their own handwriting or navigate the help system using the same set of gestures that are available in the application. (Tip: Some of the annotation features in Adobe Acrobat and Reader work well with touch-enabled interfaces.)
Can you think of any additional strategies?
SIG Activities at the Annual Conference
|
Whitney Potsus (SIG Manager) 12 March 2009 |
Categories: | • STC and SIG News |
| Comments: | 0 |
With the annual conference coming up in just a couple of months (less a few days), the Lone Writer SIG managers are starting to get some questions about SIG activities in Atlanta.
The short answer is: Details are still being worked out.
The long answer is that discussions just started yesterday on our listserv about options for the after-hours SIG get-together. If planning this year follows the same course as in previous years, date, time, and location usually gets settled a couple of weeks before the conference. When the details are available, we’ll post them here and send them out on Twitter.
With respect to the SIG “business” meeting, room reservation requests were sent in last week and conference organizers will let us know the date and time of our SIG’s meeting. (The SIG meetings have typically been early in the morning so as not to compete with the conference sessions.) Details will be posted here and on Twitter.
Stay tuned…