Hello,
On Nov 21 15:23 Martin Schmidkunz wrote (shortened):
as might have noticed I am going through the modules and try to apply
the YaST style guide to them.
...
The next issue I want to raise is the really abort library
(http://forgeftp.novell.com/yast/doc/SL11.1/modules/Popup.html#ReallyAbort)
which according to my information is used when the user made changes in
a module and closes the module.
What does "closes the module" mean?
According to my understanding of
http://en.opensuse.org/YaST/Style_Guide
the only way to abort a module is via the window decoration
-------------------------------------------------------------------------
If the user presses "Cancel" or "Close" in the window decoration
the module is closed. If the user made some changes, a warning
pop up appears, which asks the user, if he really wants to
discard his changes. The pop up is handled by
http://forgeftp.novell.com/yast/doc/SL11.1/modules/Popup.html#ReallyAbort
-------------------------------------------------------------------------
I do not find any other place in
http://en.opensuse.org/YaST/Style_Guide
which mentions "abort".
According to
http://en.opensuse.org/YaST/Style_Guide#Single_Configuration.2FOverview.2FEdit_Dialog
there is no longer a "abort" functionality which exits the
whole module. Instead this button is now named "Cancel"
and its functionality is to go back to the Overview dialog
(i.e. what the "back" button would do) because it reads
"Cancel - Closes the window and returns to the overview."
The same for
http://en.opensuse.org/YaST/Style_Guide#Configuration_Wizard
there is also no longer a "abort" functionality which exits
the current wizard or even the whole module.
The only way out is the "Cancel" butten and its functionality
is also to go back to the Overview dialog because it reads
"Cancel - Closes the window and returns to the overview."
On the other hand this is in contradiction to
http://en.opensuse.org/YaST/Style_Guide/Why_Use_Cancel
which reads
-----------------------------------------------------------
The controversy about the label of the "Cancel" button
is a very, very old one.
Up to now (August 2008) "Abort" is used as label
-----------------------------------------------------------
which implies that the button with the label "Cancel"
has "abort" functionality.
Is it understandable?
No.
It is confusing as long as you do not describe very pedantic
the exact meaning (i.e. the exact functionality) of a button
or whatever else dialog element (i.e. widget).
I suggest that you make some kind of "glossary" about
the exact meaning of the words which you use to describe
the functionality of a dialog element and of the words
which you use to label a dialog element (e.g. a button).
For example what exactly is meant with an "abort" functionality?
At least for me "abort" means
"emergency exit immediately here regardless of the consequences"
i.e. something like "kill" the process or even "kill -9" it.
Kind Regards
Johannes Meixner
--
SUSE LINUX Products GmbH, Maxfeldstrasse 5, 90409 Nuernberg, Germany
AG Nuernberg, HRB 16746, GF: Markus Rex
--
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
