[release-notes/gnome-3-4] [users] general updates

[Allan Day <allanday src gnome org>]

commit a752535a1a37132d9b8552b29ab87f907dcc262f
Author: Allan Day <allanpday gmail com>
Date:   Mon Mar 19 11:10:10 2012 +0000

    [users] general updates

 help/C/rnusers.xml |   99 +++++++++++++++++++++++++--------------------------
 1 files changed, 49 insertions(+), 50 deletions(-)
---
diff --git a/help/C/rnusers.xml b/help/C/rnusers.xml
index f997c8a..b0e3f64 100644
--- a/help/C/rnusers.xml
+++ b/help/C/rnusers.xml
@@ -21,14 +21,15 @@
   <para>
     This release also contains some important new developments. GNOME 3 applications have 
     been a major focus for recent design and development effort, and a host of applications 
-    have had significant updates for the release. You will also see a host of 
-    improvements to the building blocks that make up GNOME 3 applications in this release. 
-    This includes smooth scrolling, refreshed user interface components, a much refined 
-    visual theme and application menus.
+    have had significant updates for this release. You will also see improvements to the 
+    building blocks that make up GNOME 3 applications in this release. This includes smooth 
+    scrolling, refreshed user interface components, a much refined visual theme and 
+    application menus.
   </para>
   <para>
-    Other highlights for this release include a new document search facility and a 
-    new animated background that updates over the course of the day.
+    Other highlights for this release include a new document search facility, smooth scrolling,
+    a new application, called Boxes, and a new animated background that updates over the course 
+    of the day. Enjoy!
   </para>
 
   <sect3 id="rnusers.gnome-3-applications">
@@ -97,18 +98,18 @@
     <title>Application Menus</title>
     <para>
       Application menus are a new feature that will become an increasingly
-      familiar part of our applications in the future. These menus, which can be
-      accessed from the top bar, provide a new space for global application
-      options and actions, such as application preferences or documentation.
+      familiar part of GNOME 3 applications in the future. These menus, which 
+      are labelled with the application's name and can be seen in the top bar, 
+      provide a new space for global application options and actions, such as 
+      application preferences and documentation.
     </para>
     <para>
       A number of applications, including <application>Documents</application>, 
       <application>Web</application> and <application>Contacts</application>, are 
-      providing application menus for this release. In the future they will become 
-      an increasingly common part of our applications.
+      making use of application menus for this release.
     </para>
     <para>
-      TODO: This might all be lies + structure needs work.
+      TODO: This might all be lies + structure needs work. [aday: it's all news to me]
       When maximized, supporting applications will hide their menu bar. An
       exception has been made for focus-follows-mouse users; for them, the menus
       will never be hidden. This as a hidden menu bar is more difficult to use
@@ -119,8 +120,8 @@
   <sect3 id="rnusers.interface-components">
     <title>Refreshed Interface Components</title>
       <para>
-        A number of basic interface components have been modernized this release. 
-        These changes will make our applications more elegant and easier to use. They are 
+        A number of GNOME application interface components have been modernized this release. 
+        These changes will make applications more elegant and easier to use. They are 
         particularly focused on removing difficult click targets.
       </para>
       <figure id="fig.users.colorchooser">
@@ -134,19 +135,19 @@
           </imageobject></mediaobject></screenshot>
       </figure>
     <para>
-      The color chooser dialog has been brought up to date. The new design provides 
-      easy access to a tasteful palette of colors, and is much more straightforward to 
-      use than the previous version.
+      The GNOME color chooser dialog has been brought up to date for &gnomeversion;. The new 
+      design provides easy access to a tasteful palette of colors, as well as a mechanism to 
+      create a set of custom colors. It is much more straightforward to use than the previous 
+      version.
     </para>
     <para>
-      Scrollbars are another component that have been updated for
-      &gnomeversion;. The new version takes up less space and removes the tiny
-      'stepper' buttons that traditionally feature on scrollbars.
+      Scrollbars are another component that have been updated for &gnomeversion;. The new 
+      version takes up less space and removes the tiny 'stepper' buttons that traditionally 
+      feature on scrollbars, and which can be a particularly difficult click target.
     </para>
     <para>
-      We also included new spin buttons for &gnomeversion;. The previous
-      versions were small and fiddly. The new ones are much easier to use, and
-      look great too.
+      We also revised the design of spin buttons for &gnomeversion;, which used to be fiddly. 
+      The new versions are much easier to use and look great too.
     </para>
   </sect3>
 
@@ -158,7 +159,7 @@
       increase in quality.
     </para>
     <para>
-      The visual theme is a lot more polished in this release. Many of the
+      The GNOME 3 visual theme is a lot more polished in this release. Many of the
       changes are subtle, but almost every part of the theme has been improved
       in some way. The overall effect is much better looking applications.
     </para>
@@ -167,44 +168,41 @@
         url="https://live.gnome.org/EveryDetailMatters";>Every Detail
         Matters</ulink>, has been focusing on improving the quality of the
       Activities Overview for this release. Thanks to these efforts, lots of
-      bugs have been fixed and improvements made.
+      bugs have been fixed and improvements made, including improved application 
+      launcher labels, new window labels and captions, better keyboard navigation, 
+      more legible text styles and an easier to use dash.
     </para>
     <para>
-      Improvements that have been made through the Every Detail Matters initiative include 
-      improved application launcher labels, new window labels and captions, better 
-      keyboard navigation, more legible text styles and an easier to use dash.
-    </para>
-    <para>
-      GNOME &gnomeversion; include a great number of other incremental
-      improvements to the core user experience. There are too many things to
-      list here, but they include:
+      GNOME &gnomeversion; includes a great number of other incremental improvements 
+      to the core user experience. There are too many things to list here, but they 
+      include:
     </para>
     <itemizedlist>
       <listitem><para>
-        TODO: integrated keyring dialogs and network password dialogs
         <!-- http://bugzilla.gnome.org/show_bug.cgi?id=658484 -->
+        Network password dialogs, including those for VPN passwords, were stuck on 
+        GNOME 2 until this release. They have now been fully integrated with the GNOME 3 
+        experience.
       </para></listitem>
       <listitem><para>
-          <!--
-          http://git.gnome.org/browse/gnome-shell/commit/?id=50aa15dec9c64d6b08fc863bdb909ab07438c110
-          -->
-          The return of Wanda the Fish! It is an <ulink
-            url="http://en.wikipedia.org/wiki/Easter_egg_%28media%29#Computer-related_Easter_eggs";>easter
-            egg</ulink>, so we won't tell you exactly how to get this. For those
-          who know, search and you'll receive.
+        <!--
+        http://git.gnome.org/browse/gnome-shell/commit/?id=50aa15dec9c64d6b08fc863bdb909ab07438c110
+        -->
+        The return of Wanda the Fish! Yes Wanda, our trusty friend from GNOME 2, has returned. She's an <ulink
+          url="http://en.wikipedia.org/wiki/Easter_egg_%28media%29#Computer-related_Easter_eggs";>easter
+          egg</ulink>, so we won't tell you exactly where to find her. Search and you'll receive.
       </para></listitem>
       <listitem><para>
         <!-- https://bugzilla.gnome.org/show_bug.cgi?id=669066 -->
-        TODO: FACT CHECK!
-        The screen recorder, a hidden feature accessible by pressing
-        <keysym>Control+Shift+Alt+R</keysym>, now produces smoother videos while
-        also using less system resources. Furthermore, the video files produced
-        will now be saved in the Videos folder.
+        GNOME 3's built in screen recorder now produces smoother videos while also using less 
+        system resources. To use it, simply press <keysym>Control+Shift+Alt+R</keysym>.
       </para></listitem>
       <listitem><para>
-  		  Improved color calibration, which will now remember which device a particular profile is for.
+  		  Various color calibration improvements, which will now remember which device a particular 
+        color profile is for.
       </para></listitem>
       <listitem><para>
+        TODO: this has something to do with suspend and monitor blanking. Get more details from hadess.
 		    Better handling of docking stations and plugging of external monitors.
       </para></listitem>
       <listitem><para>
@@ -214,11 +212,12 @@
         TODO: improved network menu.
       </para></listitem>
       <listitem><para>
-        TODO: vague!
-        Better looking system modal dialogs.
+        The visual layout of system modal dialogs has been improved since &lastversion;. They look much 
+        nicer as a result.
       </para></listitem>
       <listitem><para>
-        Several important notifications improvements. For one, notification pop-ups will
+        Several important improvements have been made to notifications. For one, 
+        notification pop-ups will
         avoid the pointer so that they do not get in the way. Secondly, if you
         were away a summary of the notification will be shown once you are back.
         Lastly, we have limited the notification overview trigger to only the