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.
Subject:Re: Toolbar vs Menu From:"Robin M. Allen" <rmallen -at- TEXAS -dot- NET> Date:Tue, 18 Nov 1997 14:10:00 -0600
Scott Miller wrote:
>
> When you document a procedure, do you document the toolbar method or the
> menu/command method or both, and why?
>
> The toolbar method:
>
> 1. Click {picture of toolbar icon}
>
> The menu/command method:
>
> 1. Choose File - New.
>
> Both:
>
> 1. Choose File - New.
> {picture of toolbar icon}
>
> Disclaimers:
>
> - I looked in the archives already.
>
> - This is not a discussion about the wording of "Choose File - New" or
> "From the File menu, choose New," or "Click the pointing-device pointer
> at the File pull down menu in the menu bar and clickify the New menu
> command option thang." That's in the archives.
>
> Thanks,
>
> - Scott Miller
> smiller -at- portal -dot- com
>
Scott:
I typically document only one way to get somewhere, but you can do both
if that's what your user's want. If you can get to everything from the
menu and only certain things from the toolbar, then I always document
the menu. I'll also put a "Command Reference" appendix that outlines how
you can get there from here.
:Robin Allen
Contract Technical Writer mailto:rmallen -at- texas -dot- net