Synonym Misnomers

j j at clsdesignassociates.com
Sat Mar 20 12:48:06 EST 2004


> I'm not sure what's up with that, as I just searched for "submenu" in 
> the "Search Docs" tool and found "Recipe for populating a text menu", 
> which uses building a Text menu as an example and includes this 
> callout note:

Absolutely no offense intended by this message, Richard.

Imagine you are a new Rev user.  After typing "submenu" into the 
"Search Docs" tool, one gets a list of nearly 40 topic hits.  Scanning 
the titles of these, there is no chance most novice users would ever 
think that any of them were about creating submenus.

If I were a new Rev user, how could I be expected to know that "Recipe 
for populating a text menu" was about creating submenus?  Why does it 
say "recipe?"  Is it about cooking?  What in the world does 
"populating" mean?  And "text menu?"  I didn't even know there were any 
other kinds of menus in computer software.  I mean, I have never seen a 
picture menu in Microsoft Word.  Why do none of the topics say 
"Creating a submenu?"

My point is that the Rev docs, while well written, are not presented in 
a format that is very approachable by the new user.  Tips need to be 
taken from Apple's example; Apple still writes the best documentation 
ever for the novice user.

J.



More information about the use-livecode mailing list