[gnome-user-docs/wip/3-16-notification-update] Various updates to shell-notifications

[Michael Hill <mdhill src gnome org>]

commit 7dfbd6b276adf5764009848e7c437369ad02f996
Author: Michael Hill <mdhill gnome org>
Date:   Sat Mar 7 18:01:55 2015 -0500

    Various updates to shell-notifications

 gnome-help/C/shell-notifications.page |   38 ++++++++++++++++++--------------
 1 files changed, 21 insertions(+), 17 deletions(-)
---
diff --git a/gnome-help/C/shell-notifications.page b/gnome-help/C/shell-notifications.page
index d65d310..2b7f512 100644
--- a/gnome-help/C/shell-notifications.page
+++ b/gnome-help/C/shell-notifications.page
@@ -10,6 +10,7 @@
     <revision pkgversion="3.8.0" version="0.3" date="2013-04-23" status="review"/>
     <revision pkgversion="3.10" date="2013-11-02" status="review"/>
     <revision pkgversion="3.13.92" date="2014-09-22" status="review"/>
+    <revision pkgversion="3.15.91" date="2015-03-07" status="review"/>
 
     <credit type="author">
       <name>Marina Zhurakhinskaya</name>
@@ -36,7 +37,7 @@
   <title>What is a notification?</title>
 
   <p>If an application or a system component wants to get your attention, a
-  notification will be shown at the bottom of the screen.</p>
+  notification will be shown at the top of the screen.</p>
 
   <p>For example, if you get a new chat message, plug in an external device
   (like a USB stick), new updates are available for your computer, or your
@@ -53,7 +54,7 @@
 
   <media type="image" width="500" src="figures/notification-buttons.png"/>
 
-  <p>Clicking the close button of a notifications dismisses it.</p>
+  <p>Clicking the close button of a notification dismisses it.</p>
 
 </section>
 
@@ -61,17 +62,20 @@
 
   <title>The message list</title>
 
-  <p>The message list on the left side of
-  the calendar popup gives you a way to get back to your notifications when it
-  is convenient for you. It appears when you click the clock on the top bar,
-  or press <keyseq><key xref="keyboard-key-super">Super</key><key>V</key></keyseq>.
+  <p>The message list on the left side of the calendar popup gives you a way to
+  get back to your notifications when it is convenient for you. It appears when
+  you click the clock on the top bar, or press
+  <keyseq><key xref="keyboard-key-super">Super</key><key>V</key></keyseq>.
   The message list contains the notifications that you have not acted upon.
-  Up to three notifications per applications are kept in the list.</p>
+  Up to three notifications per application are kept in the list.</p>
 
-  <p>You can open the application for each the notifications by clicking on it.</p>
+  <p>You can open the application for each of the notifications by clicking on
+  it.</p>
+
+  <p>Clicking the close button clears the message list.</p>
 
   <p>You can close the message list by pressing
-  <keyseq><key>Super</key><key>V</key></keyseq> again or <key>Esc</key>.</p>
+  <keyseq><key>Super</key><key>V</key></keyseq> again or the <key>Esc</key>.</p>
 
 </section>
 
@@ -79,7 +83,7 @@
 
   <title>Hiding notifications</title>
 
-  <p>If you're working on something and do not want to be bothered, you can
+  <p>If you are working on something and do not want to be bothered, you can
   switch off notifications.</p>
 
   <steps>
@@ -91,16 +95,16 @@
       <p>Click on <gui>Notifications</gui> to open the panel.</p>
     </item>
     <item>
-      <p>Switch <gui>Show Pop Up Banners</gui> to <gui>OFF</gui>.</p>
+      <p>Switch <gui>Notification Banners</gui> to <gui>OFF</gui>.</p>
     </item>
   </steps>
 
-  <p>When switched off, most notifications will not pop up at the bottom of the
-  screen. Very important notifications, such as when your battery is critically
-  low, will still pop up. Notifications will still be available in the message
-  list when you display it (by moving your mouse to the bottom of the screen,
-  or by pressing <keyseq><key>Super</key><key>V</key></keyseq>), and they will
-  start popping up again when you switch the toggle to <gui>ON</gui> again.</p>
+  <p>When switched off, most notifications will no longer pop up. Very
+  important notifications, such as when your battery is critically low, will
+  still pop up. Notifications will still be available in the message list when
+  you display it (by clicking the clock on the top bar, or by pressing
+  <keyseq><key>Super</key><key>V</key></keyseq>). They will start popping up
+  again when you switch the toggle back to <gui>ON</gui>.</p>
 
 </section>