Re: HIG: Small patch to "Progress windows" section
Calum Benson <[email protected]>
| Newsgroups | gmane.comp.gnome.usability |
|---|---|
| Message-ID | <[email protected]> |
On 22 Feb 2010, at 17:17, Matthew Paul Thomas wrote: > Matthew Paul Thomas wrote on 22/02/10 17:13: >> >> This patch makes small changes to the HIG's "Progress windows" section. >> >> * New: "A progress window should always appear as an independent >> window in a window list. If progress of a task makes a window >> temporarily unusable, do not present a modal dialog-like progress >> window in front of it. Instead, present progress somewhere in the >> original window, making all its other elements temporarily >> insensitive." >> >> * Removed: "Progress windows should have the same title as their >> primary text." (This guideline has often caused redundancy in >> progress windows, e.g. >> <http://www.dedoimedo.com/images/computers/pendrivelinux_ubuntu_installing.jpg>. >> It also usually causes the window >> title to inappropriately use header capitalization.) >> >> * Added: "Progress windows should have a title representing the >> overall operation: for example “Copying Files”, “Installing”, or >> “Calling”. (As with other window titles, do not end progress window >> titles with an ellipsis.)" > > Attached. Have just submitted a slightly-modified version of this patch (attached), which improves the tagging, updates the "What's New" section, and bumps the stable version of the HIG to 2.2.1. Have made the same changes to the unstable version, which is bumped to 2.3.1. Cheeri, Calum. -- CALUM BENSON, Interaction Designer Sun Microsystems Ireland mailto:[email protected] OpenSolaris Desktop Team http://blogs.sun.com/calum +353 1 819 9771 Any opinions are personal and not necessarily those of Sun Microsystems _______________________________________________ Usability mailing list [email protected] http://mail.gnome.org/mailman/listinfo/usability
windows-patch.diff
(application/octet-stream, 4.2 KB)
diff --git a/hig/C/hig-book.xml b/hig/C/hig-book.xml
index 87ea701..d879280 100644
--- a/hig/C/hig-book.xml
+++ b/hig/C/hig-book.xml
@@ -23,11 +23,11 @@
<bookinfo>
<author role="maintainer"><firstname>The GNOME Usability Project</firstname></author>
<copyright>
-<year>2002-2008</year>
+<year>2002-2010</year>
<holder>Calum Benson, Adam Elman, Seth Nickell, colin z robertson</holder>
</copyright>
-<pubdate>2008-09-25</pubdate>
-<edition>2.2</edition>
+<pubdate>2010-03-02</pubdate>
+<edition>2.2.1</edition>
<abstract role="description">
<para>This document tells you how to create applications that look right, behave
@@ -60,7 +60,7 @@ the GNOME interface are covered.</para>
</para>
</legalnotice>
-<title>GNOME Human Interface Guidelines 2.2</title>
+<title>GNOME Human Interface Guidelines 2.2.1</title>
</bookinfo>
diff --git a/hig/C/hig-ch-whatsnew.xml b/hig/C/hig-ch-whatsnew.xml
index d0c2498..9c502ec 100644
--- a/hig/C/hig-ch-whatsnew.xml
+++ b/hig/C/hig-ch-whatsnew.xml
@@ -4,12 +4,15 @@
<preface id="whatsnew">
<title>What's new?</title>
<para>This section highlights recent changes to the HIG that may affect your application.</para>
- <para>The following changes were made in HIG v2.2:</para>
+ <para>The following changes were made in HIG v2.2.1:</para>
<itemizedlist>
- <listitem><para>Mention deprecation of low contrast icons in <xref linkend="icons-design-accessible"/>
+ <listitem><para>Mention in <xref linkend="windows-progress"/> that in-place progress
+ indicators are preferred to modal progress dialogs windows.
</para></listitem>
<listitem><para>
- Updated illustrations throughout.
+ Replace guidance in <xref linkend="windows-progress"/> about progress windows having
+ same title as their primary text, which lead to unnecessary redundancy. Advice is now
+ that progress window title should summarize the overall operation.
</para></listitem>
</itemizedlist>
@@ -68,7 +71,7 @@
<listitem><para>
<xref linkend="windows-primary"/>
</para></listitem>
-
+
<listitem><para>
<xref linkend="windows-utility"/>
</para></listitem>
diff --git a/hig/C/hig-ch-windows.xml b/hig/C/hig-ch-windows.xml
index 078b70e..ab47b0e 100644
--- a/hig/C/hig-ch-windows.xml
+++ b/hig/C/hig-ch-windows.xml
@@ -1720,13 +1720,11 @@ saved, in case an error occurs. Then hide the document window immediately after
during an operation that takes more than a few seconds. See <xref
linkend="controls-progress-bars" /> for more details about proper use of
progress bars.</para>
- <para>A progress window may appear in the panel window list if it
- is, or may be, the only window shown by an application. For example,
- the file download progress window of a web browser may remain after
- all the browser windows have been closed.</para>
- <para>Otherwise, a progress window should be raised above the
- application when the application window itself is selected from the
- window list.</para>
+
+ <para>A progress window should always appear as an independent window in a window list.
+ If progress of a task makes a window temporarily unusable, do not present a modal dialog-like progress window in front of it.
+ Instead, present progress somewhere in the original window, making all its other elements temporarily insensitive.
+ This helps reduce visual clutter.</para>
<figure id="example-progress-figure">
<title>An example of a progress window</title>
@@ -1749,9 +1747,9 @@ saved, in case an error occurs. Then hide the document window immediately after
<formalpara>
<title>Title Format</title>
- <para>Progress windows should have the same title as their primary text.
- Unlike alerts, it is expected that progress windows will be present in
- the window list and may be active for extended periods.</para>
+ <para>Progress windows should have a title representing the overall
+ operation: for example <guilabel>Copying Files</guilabel>, <guilabel>Installing</guilabel>, or <guilabel>Calling</guilabel>.
+ As with other window titles, do not end progress window titles with an ellipsis.</para>
</formalpara>
<formalpara>