Re: Command nomenclature

Subject: Re: Command nomenclature
From: Peter Kent <techwr -at- ARUNDEL -dot- COM>
Date: Mon, 9 Jun 1997 11:15:27 -0600

> I did a small survey of my company's users (mostly police officers) and
> found that over half didn't understand the convention Yvonne DeGraw
> suggests: "Choose File-->Open." However, we explain the convention only
> in
> the preface, and I suspect not many readers look at prefaces.

I sometimes explain this in the preface, but often also mention it at the
first use in the book. However, I don't really understand why anyone who
understands the GUI they're working with can't figure out this convention
fairly quickly. And of course you only have to figure it out once.

Peter Kent+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Coming in the fall, the revised Technical Writer's Freelancing
Guide. New Title: Making Money in Technical Writing. 80 percent
more info. See http://www.arundel.com/techwr for more...
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html


Previous by Author: Re: MS Manual of Style, disagreements with
Next by Author: Re: where to buy books
Previous by Thread: Re: Command nomenclature
Next by Thread: Re: Command nomenclature


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


Sponsored Ads