Dainis,

I prefer the title Download Manager Options - Mail Setup Tab.

As for the menucascade, Generally I would just state something like:

Click <menucascade><uicontrol>menu
option</uicontrol><uicontrol>submenu
option1</uicontrol><uicontrol>sub-submenu
option1</uicontrol></menucascade> to do whatever...

Basically this interprets as follow the path to get to the lowest
option and click to complete the action. I would consider taking the
same approach through other parts of an interface, though an argument
can be made for breaking down the path into more discrete groups as
separate steps.

Hope this helps.

Julio J. Vazquez
SDI

--- In dita-users@yahoogroups.com, Dainis Michel <dainis.michel@...>
wrote:
>
> Hi All,
>
> I wish everyone a particularly happy day today, as it is my
engagement anniversary. I asked my wife to be my bride during the
annual July 4th Chicago lakefront fireworks, which take place every
year...on July 3d. :-)
>
> Today, I am considering how to title our reference topics using DITA.
>
> For example:
>
> <title>Download Manager Options | [Tab] Mail Setup</title>
>
> That kind of title gives some good info. You're in Download Manager
Options, and you're viewing the help for the Mail Setup tab.
>
> However, I've worked out the following use of menucascade:
>
> <menucascade>
>
> <uicontrol>Tools</uicontrol>
>
> <uicontrol>Options...</uicontrol>
>
> <uicontrol>[Tab] Security</uicontrol>
>
> </menucascade>
>
> ...and BTW, we'll eventually be pulling the "where is it?" question
entirely from the application itself (and inserting into menucascade),
so I'm feeling pretty geeky-ego-coolified about that!
>
> Now, my questions are:
>
> How descriptive should the title be?
>
> Here are some options:
>
> 1. Mail Setup (all the rest of the info is explained in the topic)
>
> 2. Mail Setup Tab (tells more about what it is, but breaks my
"QuickProcedure" methodology, which for example works like this:
>
> QuickProcedure
>
> Menu MarketData | [select] Market Data Type | [screen] Search for
and find the data item you wish to edit | [action] Overwrite the data
item | [action] Complete the task by pressing Tab, Enter, or by
continued use of TBD.
>
> and
>
> QuickProcedure
>
> [Windows Taskbar] Click Start | All Programs | [menu] Bulldog
Download Manager | [submenu] select Bulldog Download Manager |
[screen] click OK.
>
> ...and even though I'm still working on the details of the
QuickProcedure, I feel like it will be very helpful once I've worked
out the kinks. One of the kinks is: do I bracket things like
[select]..., or [action] select XYZ, or do I just point out [menu]
[submenu] [screen] [tab], etc.?
>
> If I use the methodology [tab] Tabname select the XYZ checkbox, then
I'd likely want to do something like
>
> 3. [Tab] Mail Setup
>
> for my reference topic titles
>
> or even, what I've come to for now:
>
> 4. Download Manager Options | [Tab] Mail Setup
>
> The more I think of it, the more I'm leaning towards naming the
reference topic as specifically as possible, which would be Mail
Setup, and that's it. Maybe Mail Setup Tab.
>
> Your thoughts and suggestions are most welcome...and hey...wanna
help me with my QuickProcedure methodology?
>
> Cheers!
>
> Dainis
>
> -------------------------------
> Dainis W. Michel
> Documentation
> Comfin Software & Consulting Services GmbH
> Wollzeile 6-8
> 1010 Vienna, Austria
> Tel: +43 1 513 4704
> Fax: +43 1 513 4703
> -------------------------------
>
http://www.music-composition-studio.com<http://www.music-composition-studio.com/\
>
> http://www.sustainable-bliss.com<http://www.sustainable-bliss.com/>
> http://www.liquidenglish.com<http://www.liquidenglish.com/>
>