Re: [Gimp-developer] Re: [Gimp-docs] adding a help button to GimpDialog
Hi, first of all: it is a great idea to add help buttons to all dialogs. Not only that it makes it more obvious that GIMP has a help system, but it also offers the opportunity of providing *real* context sensitive help. That's exactly what we once-in-a-while users need 8-) I checked the gnome hig to see if there are rules when to apply a help button to dialogs, but unfortunately, that section is missing. However, the general rule should be: 'If a dialog requires further action and a specific help is available, provide a help button.' That means - a simple confirmation dialog where no further settings/actions can be performed does not need to have a help button. - if no help is available for a dialog, do not provide the help button as it will confuse and annoy the user (it will keep the user from calling help in the future. Does help_func check that?) - if possible, provide context sensitive help (open the corresponding chapter in the help pages). Please also make sure that the help button appears at the same location in each dialog. Best place it at the lower left edge, possibly leaving some space to the action buttons (I know, this will make the dialog even broader, but it will also aid to unclutter the layout). Hope that was of help, greetings /ellen On Mon, 2004-10-04 at 16:33, Sven Neumann wrote: Hi, the responses have been very positive so far, so I've given this a little more testing. There are a couple of dialogs where the help button is not appropriate and just looks odd. These are mainly confirmation dialogs like for example the one you get when you close an image. I suggest that we don't set a help-id on such dialogs. We can set the help_func so that pressing F1 opens the help-browser with the default page but there would not be a help button. In particular this means removing the following help-ids: #define GIMP_HELP_FILE_NEW_CONFIRM gimp-file-new-confirm #define GIMP_HELP_FILE_SAVE_OVERWRITEgimp-file-save-overwrite #define GIMP_HELP_FILE_CLOSE_CONFIRM gimp-file-close-confirm #define GIMP_HELP_FILE_QUIT_CONFIRM gimp-file-quit-confirm #define GIMP_HELP_EXPORT_CONFIRM_DIALOG gimp-export-confirm-dialog Would that make sense? There are a couple of other dialogs where the help button disturbs the dialog layout and I am sure there are some dialogs that I didn't look at yet. So if you agree with the above change I will investigate what needs to be done to make the help button configurable. If it turns out that this is feasible, I would commit this change so that it can see some more testing with the 2.1.6 release. Sven ___ Gimp-developer mailing list [EMAIL PROTECTED] http://lists.xcf.berkeley.edu/mailman/listinfo/gimp-developer -- __ Ellen Reitmayr email: [EMAIL PROTECTED] Usability Engineer mobil: +49.177.3325867 relevantive AG fon: +49.30.23455630 Zehdenicker Str. 21 fax: +49.30.23455639 10119 Berlinweb: www.relevantive.de ___ signature.asc Description: This is a digitally signed message part
Re: [Gimp-developer] Re: [Gimp-docs] adding a help button to GimpDialog
Hi, Ellen Reitmayr [EMAIL PROTECTED] writes: - if no help is available for a dialog, do not provide the help button as it will confuse and annoy the user (it will keep the user from calling help in the future. Does help_func check that?) No, there is no way for GIMP to find out whether a particular help page exists. Actually there is always a help page available but for some topics it will simply say something along the lines of: No help has been written on this topic yet. If you want to help, join the help authors IMO this is acceptable. It would however be interesting to know how many of the help-ids are already covered in gimp-help-2. Do such figures exist? - if possible, provide context sensitive help (open the corresponding chapter in the help pages). That's what we have been doing since GIMP 1.2. We just did not have help buttons. Pressing F1 in a dialog does however get you directly to the corresponding help page and so does pressing F1 with a menu item focused. Please also make sure that the help button appears at the same location in each dialog. Best place it at the lower left edge, possibly leaving some space to the action buttons (I know, this will make the dialog even broader, but it will also aid to unclutter the layout). That is the layout we have choosen. Well, there isn't necessarily extra spacing between the help button and the action buttons but then GtkDialog doesn't really give us a lot of choice here. Sven ___ Gimp-developer mailing list [EMAIL PROTECTED] http://lists.xcf.berkeley.edu/mailman/listinfo/gimp-developer
[Gimp-developer] Re: [Gimp-docs] adding a help button to GimpDialog
Hi, the responses have been very positive so far, so I've given this a little more testing. There are a couple of dialogs where the help button is not appropriate and just looks odd. These are mainly confirmation dialogs like for example the one you get when you close an image. I suggest that we don't set a help-id on such dialogs. We can set the help_func so that pressing F1 opens the help-browser with the default page but there would not be a help button. In particular this means removing the following help-ids: #define GIMP_HELP_FILE_NEW_CONFIRM gimp-file-new-confirm #define GIMP_HELP_FILE_SAVE_OVERWRITEgimp-file-save-overwrite #define GIMP_HELP_FILE_CLOSE_CONFIRM gimp-file-close-confirm #define GIMP_HELP_FILE_QUIT_CONFIRM gimp-file-quit-confirm #define GIMP_HELP_EXPORT_CONFIRM_DIALOG gimp-export-confirm-dialog Would that make sense? There are a couple of other dialogs where the help button disturbs the dialog layout and I am sure there are some dialogs that I didn't look at yet. So if you agree with the above change I will investigate what needs to be done to make the help button configurable. If it turns out that this is feasible, I would commit this change so that it can see some more testing with the 2.1.6 release. Sven ___ Gimp-developer mailing list [EMAIL PROTECTED] http://lists.xcf.berkeley.edu/mailman/listinfo/gimp-developer