Difference between revisions of "Projects/Usability/HIG/Contributing"

< Projects‎ | Usability‎ | HIG
Jump to: navigation, search
(Projects/Usability/HIG/Notifications: Removed TODOs, marked the page under construction instead)
(Projects/Usability/HIG/Slider_and_Spin_Box)
(18 intermediate revisions by 2 users not shown)
Line 12: Line 12:
 
= TODO =
 
= TODO =
 
== Start page ==
 
== Start page ==
* Figure out what to do of the legacy stuff (at the bottom of the page)
+
*<s> Figure out what to do of the legacy stuff (at the bottom of the page)</s>
  
 
== [[Projects/Usability/HIG/Dialogs]] ==
 
== [[Projects/Usability/HIG/Dialogs]] ==
 
* Fix missing page: [[Design_and_Layout:Interaction:Input#Inline Editing|inline-editing]]  
 
* Fix missing page: [[Design_and_Layout:Interaction:Input#Inline Editing|inline-editing]]  
 
* Fix missing page: [[Guidelines:Info Panel|info panels]]
 
* Fix missing page: [[Guidelines:Info Panel|info panels]]
 +
* Review guidelines about alignments: they duplicate/contradict the one from [[Projects/Usability/HIG/Form_Label_Alignment|Form: Label Alignment]]
  
 
== [[Projects/Usability/HIG/ListView]] ==
 
== [[Projects/Usability/HIG/ListView]] ==
 +
<s>
 
=== Purpose ===
 
=== Purpose ===
 
Recommendation should be checked
 
Recommendation should be checked
Line 31: Line 33:
 
# 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
 
# 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
 
# Use a list box for multiple selections with more than five options.  
 
# Use a list box for multiple selections with more than five options.  
 +
</s>
  
 
Get a new type of check boxes for list views implemented: KCheckBoxes:
 
Get a new type of check boxes for list views implemented: KCheckBoxes:
Line 37: Line 40:
 
* KCB have a fade-in effect on mouse over to introduce themselves to users.
 
* 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.
 
* 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.  
+
* 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]] ==
 
== [[Projects/Usability/HIG/Check_Box]] ==
 
* Redo screenshots using Designer
 
* Redo screenshots using Designer
* Fix missing page: [[Projects/Usability/HIG/ListBox| list]]
+
* <s>Fix missing page: [[Projects/Usability/HIG/ListBox| list]]</s>
  
 
== [[Projects/Usability/HIG/SOU_Workspace/Two_Lists]] ==
 
== [[Projects/Usability/HIG/SOU_Workspace/Two_Lists]] ==
* Move to Projects/Usability/HIG/Two_Lists? That is, drop "SOU_Workspace" from the url
+
* <s>Move to Projects/Usability/HIG/Two_Lists? That is, drop "SOU_Workspace" from the url</s>
 
* Redo screenshots using Designer
 
* Redo screenshots using Designer
* Fix missing page: [[../Selecting Items from a Pool|Selecting Items from a Pool]]
+
* <s>Fix missing page: [[../Selecting Items from a Pool|Selecting Items from a Pool]]</s>
* Fix missing page: [[../Picker Dialog|Picker Dialog]]
+
* <s>Fix missing page: [[../Picker Dialog|Picker Dialog]]</s>
  
 
== [[Projects/Usability/HIG/Slider]] ==
 
== [[Projects/Usability/HIG/Slider]] ==
* Refresh page: it is copied from GNOME guidelines and contains references to figures we do not have
+
* <s>Refresh page: it is copied from GNOME guidelines and contains references to figures we do not have</s>
  
 
== [[Projects/Usability/HIG/Notifications]] ==
 
== [[Projects/Usability/HIG/Notifications]] ==
 
* Finish it (currently marked "Under Construction")
 
* 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]] ==
 +
* Examples and illustrations
 +
* <s>What happens if when SSB gets the focus?</s>
 +
* <s>Do we want to encourage the use of combined control?</s>
 +
* <s>In which case should the simple slider be favored?</s>
 +
 +
== [[../edits]]==
 +
* <s>Split in two pages: line edits and text edits</s>
 +
 +
== [[../Combo_Box]]==
 +
* <s>Split in two pages: drop-down and combobox</s>
  
 
== kdehig repository ==
 
== kdehig repository ==
Line 59: Line 92:
 
* Move it to KDE playground
 
* Move it to KDE playground
 
* Integrate designer files from http://techbase.kde.org/File:HIG-UI-Files.tar.gz
 
* Integrate designer files from http://techbase.kde.org/File:HIG-UI-Files.tar.gz
 +
 +
= Wish list =
 +
* Balloons
 +
[[File:Balloon.png]]

Revision as of 15:05, 1 August 2013

Contents

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

  • Examples and illustrations
  • 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?

Projects/Usability/HIG/edits

  • Split in two pages: line edits and text edits

Projects/Usability/HIG/Combo_Box

  • Split in two pages: drop-down and combobox

kdehig repository

Wish list

  • Balloons

Balloon.png


KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V.Legal