RE: Style Question

[Ada Lai <adalai2000@xxxxxxxxx>]

Ananda,

Thanks to you and the many other "Framers" who have responded to me.

With just these few arguments, I have achieved an agreement to adopt that 
the de-facto "standard" style of

   Format > Document > Numbering

The funny (and stupid) thing is that, I just researched something in the FM 
manual and because I am so comfortable with that notation, it never even 
hit me that it was being used and that I could use that fact as a 
"supporting argument" for my position.

I agree that the ">" is more natural and more in character with the manner 
in which the menus themselves function.

Another important point regarding this that, Mike Tatro brought up is that 
of "bolding" the menu command string. I also prefer to do that, as it makes 
the sentence more readable.

Thanks again to everyone!

Ada Lai

-----Original Message-----
From:	Stevens, Ananda [SMTP:Ananda.Stevens@windriver.com]
Sent:	Wednesday, September 06, 2000 2:48 PM
To:	'Ada Lai'; 'framers@omsys.com'
Subject:	RE: Style Question

> what character [do] you use to separate the multiple levels
> of menu commands/options?

Someone here used to use "Select Format | Document | Numbering".
But when I started writing, I used > instead of |, without really
thinking why. I suspect it's because the > seems more natural:
 - submenus are generally indicated by a triangle pointing
   to the right
 - submenus usually appear to the right of the main menu
 - the > reinforces the parent > child relationship of the
   main menu > submenu
 - the > indicates a redirect in UNIX, which isn't that far
   off the mark in a menu > submenu selection

>From my bookshelf, some of the manuals that use the
menu > submenu convention:
 - FrameMaker
 - IXgen
 - Photoshop
 - Kai's Power Tools
 - Illustrator
 - GoLive
 - Visio

There is one book that does not use the > character, but it uses
an arrow dingbat character.

> Should we bite the bullet and adopt the verbal approach of
> describing how to navigate the menus?

Definitely _not_.

As a user, I can get the information much quicker from the
"main menu > submenu" shorthand notation than from a full
sentence of "select the menu and then select the submenu"!
Also, if you are reading a manual written in another language,
the "menu > submenu" convention eliminates some confusion --
since some people will write "Select the submenu from the menu"
rather than "select the menu and then the submenu".
(Been there, done that with the kanji in the Japanese Windows9x
installation... navigation by pattern recognition, anyone? ;-)

HTH,
Ananda Stevens
ananda.stevens@windriver.com

_________________________________________________________
Do You Yahoo!?
Get your free @yahoo.com address at http://mail.yahoo.com


** To unsubscribe, send a message to majordomo@omsys.com **
** with "unsubscribe framers" (no quotes) in the body.   **