[gnome-devel-docs] HIG - add guidance on using the escape key

[Allan Day <allanday src gnome org>]

commit f6e60f87203ad4e74fe1da262735aa8e3c375fd0
Author: Allan Day <allanpday gmail com>
Date:   Tue Sep 30 14:49:56 2014 +0100

    HIG - add guidance on using the escape key

 hig/C/dialogs.page        |   10 +++++-----
 hig/C/keyboard-input.page |    4 ++++
 2 files changed, 9 insertions(+), 5 deletions(-)
---
diff --git a/hig/C/dialogs.page b/hig/C/dialogs.page
index ae07a49..b52e0d6 100644
--- a/hig/C/dialogs.page
+++ b/hig/C/dialogs.page
@@ -137,14 +137,14 @@
 
 </section>
 
-<section id="default-buttons">
-<title>Defaults</title>
+<section id="default-action-and-escape">
+<title>Default action and escape</title>
 
-<p>When designing a dialog window, you can assign the return key to activate a particular button in the 
window. GNOME 3 indicates this button by giving it the <link 
xref="buttons#suggested-and-destructive">suggested action style</link>.</p>
+<p>Assign the return key to activate the primary affirmative button in a dialog (for example 
<gui>Print</gui> in a print dialog). This is called the default action, and is indicated by a different 
visual style. Do not make a button the default if its action is irreversible, destructive or otherwise 
inconvenient to the user. If there is no appropriate button to designate as the default button, do not set 
one.</p>
 
-<p>Choose the default button to be the most likely action, such as a confirmation action or an action that 
applies changes. Do not make a button the default if its action is irreversible, destructive or otherwise 
inconvenient to the user. If there is no appropriate button in your window, to designate as the default 
button, do not set one.</p>
+<p>You should also ensure that the escape key activates the cancel or close button, should either of them be 
present. Message dialogs with a single button can have both escape and return bound to the button.</p>
 
-<p>In particular, it is not recommended to make the <gui>Close</gui> button the default in an instant apply 
window, as this can lead to users closing the window accidentally before they have finished using it.</p>
+<p>Binding return and escape in this way provides a predictable and convenient way to continue through a 
dialog, or to go back.</p>
 
 </section>
 
diff --git a/hig/C/keyboard-input.page b/hig/C/keyboard-input.page
index fa859fd..90a8d5e 100644
--- a/hig/C/keyboard-input.page
+++ b/hig/C/keyboard-input.page
@@ -103,6 +103,10 @@
 <td><p><key>PageUp</key>, <keyseq><key>Ctrl</key><key>PageUp</key></keyseq>, <key>PageDown</key> and 
<keyseq><key>Ctrl</key><key>PageDown</key></keyseq></p></td>
 <td><p>Scroll the selected view by one page up/left/down/right</p></td>
 </tr>
+<tr>
+<td><p><key>Escape</key></p></td>
+<td><p>Close or exit the current context, if it is transient. This should be consistently used for menus, 
popovers or <link xref="dialogs#default-action-and-escape">dialogs</link>, or any other temporary mode or UI 
element.</p></td>
+</tr>
 </tbody>
 </table>