User:Claus chr/Guidelines

From KDE Wiki Sandbox

Some questions to consider with respect to our typographical guidelines:

Bolding

Should we use bolding or some other markup for

  • Software, that is not operated by the user: servers, backends, libraries, ...
  • Non-KDE apps
  • Distributions

Menuchoice

  • Named sections of a window or dialog: Bolded (even when the name doesn't appear in the interface?)
  • Icon buttons with no text: Use the actual icon inline. How should the "tool tip name" be marked up when it needs to be referred to?
  • How to mark up modes?

Keycap

Only for actual key press actions. If we mention characters (rather then the key pressed to enter them) nor markup is appropriate (except perhaps quote marks)?

Other GUI elements

  • Text field with title in the fiels itself, fx Amaroks Search playlist
  • Named tools, when the name does not appear explicitely in the GUI, fx Amaroks Cover Manager or the Pop-Up Dropper
  • Concepts: should the be capitalized and italicized (only the first time)?
  • Only bold when referring to the actual GUI element, i.e. Playlist is the pane, playlist is a list created there
  • Items from a fixed list selectable from a dropdown list (fx Amaroks biases)
    • Items with names depending on some settings (fx names of items in Amaroks dynamic playlists - note, that the names of baises that can be selected when editing biases is different form the name of the bias that appear in the dynamic playlist)
  • Items in a predefined but modifiable list (typically combo box)
  • Predefined tags (as in Amarok: Artist, Title, ...)
  • Names of icon buttons
  • Buttons with both an image and a text