userguide icon indicating copy to clipboard operation
userguide copied to clipboard

Use of wintitle element

Open mbakeranalecta opened this issue 11 years ago • 2 comments

DITA provides a wintitle element for marking up the titles of windows, dialogs, wizards, etc. The current doc set uses it only once. In all other cases, window titles are marked up using uicontrol.

Was there a decision made not to use wintitle or is this simply a case of authors not making the distinction.

I can see some potential uses down the line for having window titles markup us differently from other ui elements. Windows are elements that might have topics about them, so there is the potential to use such markup for validation or linking.

It may not be worth going back and fixing all cases, but maybe it is worthwhile to start using wintitle going forward?

mbakeranalecta avatar Sep 30 '14 20:09 mbakeranalecta

Yes, I agree, it will be better to use wintitle for a dialog title than uicontrol. We need however to make sure we style this for the WebHelp output, from a quick look it seems to be rendered with the default style for text - in PDF it is rendered with bold which is fine.

georgebina avatar Oct 01 '14 12:10 georgebina

Actually we need to make the change for all XHTML-based outpus (CHM, JavaHelp).

raducoravu avatar Oct 02 '14 06:10 raducoravu