Projects/Usability/HIG/Contributing

From KDE TechBase
< Projects‎ | Usability‎ | HIG
Revision as of 12:37, 16 July 2013 by Agateau (talk | contribs) (→‎TODO)

Report problems

If you found an area that was unclear or is not even covered in our HIG, tell us about it. We can be reached on the kde-guidelines mailing-list.

Conventions

Following is a set of guidelines to ensure the HIG itself is consistent.

Terminology

  • Use the word Control, not Widget to refer to a user interface element. Rationale: "Control" is more widespread outside the UNIX community. It is also reasonable to expect more and more applications will be written using QtQuick and QtQuick controls in the future.
  • Use check box and combo box, not checkbox or combobox.

TODO

Start page

  • Figure out what to do of the legacy stuff (at the bottom of the page)

Projects/Usability/HIG/Dialogs

Projects/Usability/HIG/ListView

Purpose

Recommendation should be checked

Guidelines

Add subsections

Selection

Check against recommendation.

Choose between either:

  1. In any other case, use the dual-list pattern because it allows users to easily see which items are selected at any point, without having to scroll through the available options
  2. Use a list box for multiple selections with more than five options.

Get a new type of check boxes for list views implemented: KCheckBoxes:

  • KCB are flat (no frame, no shadow, no bevel) for clear differentiation from normal check boxes.
  • KCB are hidden by default, that means when no list item is selected.
  • KCB have a fade-in effect on mouse over to introduce themselves to users.
  • KCB are transparent and therby clearly part of the list item.
  • Legacy keyboard use applies to KCB as well. Thus, the whole item can be clicked to toggle option.

Projects/Usability/HIG/Radio_Buttons

  • Add inline examples of do and don't

Projects/Usability/HIG/Check_Box

  • Redo screenshots using Designer
  • Fix missing page: list

Projects/Usability/HIG/SOU_Workspace/Two_Lists

Projects/Usability/HIG/Slider

  • Refresh page: it is copied from GNOME guidelines and contains references to figures we do not have

Projects/Usability/HIG/Notifications

  • Finish it (currently marked "Under Construction")

Projects/Usability/HIG/KNS

  • Redo screenshots

Projects/Usability/HIG/Wording

  • Use Options for a configuration dialog which provide.: Ask Celeste what she meant to add after provide.

Projects/Usability/HIG/Exclamation_points

  • Redo screenshots

Projects/Usability/HIG/Date_Time_Pickers

  • Pick one of KDateComboBox and KDateWidget or provide guidelines explaining when to use one or the other
  • Review the dropdown of KDateComboBox: it is probably too big

Projects/Usability/HIG/Menu_Bar

  • Redo screenshots

Projects/Usability/HIG/Slider_and_Spin_Box

  • What happens if when SSB gets the focus?
  • Do we want to encourage the use of combined control?
  • In which case should the simple slider be favored?

kdehig repository

Wish list

  • Balloons