TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
> In a document I have written:
>
> "The InfoWindow, which opens when a marker or bubble is tapped, has a
> black background with white text. If multiple markers are close to each
> other, the InfoWindow includes arrows to let the user cycle through
> those markers. The report metrics are displayed in the InfoWindow in
> the order that they are listed on the report."
Why are you describing the background and text of the window. Isn't it identified by name in the title bar? What's the audience for this doc? If it's users of the interface, address them directly (2nd person) instead of in the 3rd person.
"When you tap a marker or bubble, the InfoWindow opens. If multiple markers are close to each other, use the arrows to cycle through those markers." I won't attempt the last sentence because I don't really understand what it's trying to say.
Richard G. Combs
Senior Technical Writer
Polycom, Inc.
richardDOTcombs AT polycomDOTcom
303-223-5111
------
rgcombs AT gmailDOTcom
303-903-6372
------
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days. http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-