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.
Re: Re[2]: Conventions, Intros, Overviews, Help, etc.
Subject:Re: Re[2]: Conventions, Intros, Overviews, Help, etc. From:Scott Miller <smiller -at- CORP -dot- PORTAL -dot- COM> Date:Fri, 29 May 1998 09:28:19 -0700
I would use "From the File menu, choose Exit." No need for a convention
there.
I think that my violent hatred of the conventions page comes from
writing nothing but online help for several years. WIth online help,
random access for information about a specific task is what we expect,
so we can't use potentially confusing conventions like File>Save that
rely on a conventions page. (For naive audiences, anyway. For most
users, File>Save or File - Save is just fine, I think.)
If you can't rely on a conventions page in online help, you have to
figure out how to write things so that you don't need a conventions
page. However, I also think that you can't rely on a conventions page in
a book either. Books are just as randomly-accessed as online help,
perhaps even more so.
To be honest, though, the conventions page just says "stodgy old
documentation" to me. Call it a midlife crisis, but, like, yuck.
- Scott Miller
smiller -at- portal -dot- com
------------------------------------------------------------------------
------------------------------------
> So, how would you handle explaining that "select File>Exit" means to
> select
> the file command, then select the Exit command from the File command
> drop-down list?