RE: [platform-ui-dev] Question about Eclipse UI Guidelines?

["Nick Edgar" <Nick_Edgar@xxxxxxxxxx>]

Ron is correct.  The guidelines are somewhat out of date, and we are 
working on bringing them up to the 2.1 level, among other improvements.

Nick





Ron Baldwin <ron.baldwin@xxxxxxxxxxxxxxx>
Sent by: platform-ui-dev-admin@xxxxxxxxxxx
04/25/2003 12:45 AM
Please respond to platform-ui-dev

 
        To:     "'platform-ui-dev@xxxxxxxxxxx'" <platform-ui-dev@xxxxxxxxxxx>
        cc: 
        Subject:        RE: [platform-ui-dev] Question about Eclipse UI Guidelines?



Hi Felix,
 
This is a documentation bug.  The behavior described in the docs used to 
be part of the UI guidelines, but the rule has changed and the docs have 
apparently not been updated.  The new rule is that the tooltip text for 
state buttons is static, and always describes the behavior when the button 
is "on."
 
This can be seen in the Outline view (the "Hide Fields" button) and is 
documented here: https://bugs.eclipse.org/bugs/show_bug.cgi?id=7638.
 
Ron
-----Original Message-----
From: Felix Yuan [mailto:bigbrain_cn@xxxxxxx]
Sent: Thursday, April 24, 2003 10:55 PM
To: platform-ui-dev@xxxxxxxxxxx
Subject: [platform-ui-dev] Question about Eclipse UI Guidelines?

hi,
I'm reading the article "Eclipse User Interface Guidelines" on the web 
page:http://www.eclipse.org/articles/Article-UI-Guidelines/Index.html.
And I have found that some behaviors of Eclipse do not correspond with the 
guidelines mentioned in the article.
 
For example,
Guideline 2.2 The action tooltip should describe the result of the action, not the 
current state of the action.
And a paragraph above this guideline says:
The tool tips for an action should describe the behavior which occurs if 
the action is invoked.  For instance, in the following snapshot the 
behavior of the Field button is shown.  If the action is unpressed, 
pressing the action will hide the fields.  If the action is pressed, 
unpressing the action will show the fields.  This behavior is shown using 
two tool tips. 
But actually it does not behave the same as what described above. The tip 
aways shows the same words "Hide Fields", whether the button is pressed or 
not.
 
And there are some other inconsistencies between the article and Eclipse.
Maybe my question is insignificant. But when I am devoloping a plug-in for 
Eclipse, should I conform to the guidelines  or just follow the actual 
behaviors of Eclipse?
And I wonder whether the guidelines are out ouf date or  the new version 
of Eclipse dose not conform to the guidelines.
( I use Eclipse 2.1.0 in Windows2000 pro.)
 
regards,
 
bigbrain_cn