[gnome-user-docs] Review a11y and backup pages, fix broken tag



commit f817a159c52005b32ef059ace43075cce858c7af
Author: Phil Bull <philbull gmail com>
Date:   Wed Mar 30 19:41:39 2011 +0100

    Review a11y and backup pages, fix broken tag

 gnome-help/C/a11y-contrast.page                  |   25 ++++------------
 gnome-help/C/a11y-font-size.page                 |   33 ++++------------------
 gnome-help/C/a11y-locate-pointer.page            |   19 ++++--------
 gnome-help/C/a11y-mag.page                       |   18 ++++--------
 gnome-help/C/a11y.page                           |    4 +-
 gnome-help/C/backup-frequency.page               |   30 ++++++-------------
 gnome-help/C/backup-restore.page                 |   13 +++++---
 gnome-help/C/backup-what.page                    |   12 ++++----
 gnome-help/C/nautilus-file-properties-basic.page |    2 +-
 9 files changed, 51 insertions(+), 105 deletions(-)
---
diff --git a/gnome-help/C/a11y-contrast.page b/gnome-help/C/a11y-contrast.page
index 7c8f3f9..25fe4c8 100644
--- a/gnome-help/C/a11y-contrast.page
+++ b/gnome-help/C/a11y-contrast.page
@@ -4,7 +4,7 @@
   <info>
     <link type="guide" xref="a11y#vision" group="lowvision"/>
 
-    <revision docversion="3.0" date="2010-12-14" status="review"/>
+    <revision docversion="3.0" date="2011-03-30" status="final"/>
 
     <credit type="author copyright">
       <name>Shaun McCance</name>
@@ -12,31 +12,18 @@
       <years>2010</years>
     </credit>
 
-    <desc>Increase or descrease the visual contrast of user interface elements.</desc>
+    <desc>Make windows and buttons on the screen more (or less) vivid, so they're easier to see.</desc>
   </info>
 
   <title>Adjust the contrast</title>
 
-  <comment>
-    <cite date="2010-12-14" href="mailto:shaunm gnome org">Shaun McCance</cite>
-    <p>This assumes the reader knows how to.... By the end of this page,
-    the reader will be able to....</p>
-  </comment>
-
-  <p>To adjust the contrast on your monitor:</p>
+  <p>To adjust the contrast of things on the screen:</p>
 
   <steps>
     <item><p>Click on the accessibility icon in the top panel.</p></item>
-    <item><p>Click on <gui>Universal Access Settings</gui>.  The <gui>Universal Access</gui> window will open.</p></item>
-    <item><p>Select the <gui>Seeing</gui> tab.  Under <gui>Display</gui> select the <gui>Contrast</gui> that best suits your needs from the list:</p>
-<list>
-<item><p>Low</p></item>
-<item><p>Normal</p></item>
-<item><p>High</p></item>
-<item><p>Inverse/High</p></item>
-</list>
-</item>
-  </steps>
+    <item><p>Click on <gui>Universal Access Settings</gui>. The <gui>Universal Access</gui> window will open.</p></item>
+    <item><p>Select the <gui>Seeing</gui> tab. Under <gui>Display</gui> select the <gui>Contrast</gui> that best suits your needs. <gui>Low</gui> will make things less vivid, for example.</p></item>
+</steps>
  <note style = "tip">
  <p>
 Once you have adjusted the setting in the <gui>Seeing</gui> tab to your preferred contrast, you can quickly turn the contrast <gui>ON</gui> and <gui>OFF</gui> by clicking on the accessibility icon in the top panel and then clicking on <gui>High Contrast</gui>.
diff --git a/gnome-help/C/a11y-font-size.page b/gnome-help/C/a11y-font-size.page
index c784685..3431e5c 100644
--- a/gnome-help/C/a11y-font-size.page
+++ b/gnome-help/C/a11y-font-size.page
@@ -4,7 +4,7 @@
   <info>
     <link type="guide" xref="a11y#vision" group="lowvision"/>
 
-    <revision pkgversion="3.0" date="2010-12-14" status="review"/>
+    <revision pkgversion="3.0" date="2011-03-30" status="final"/>
 
     <credit type="author copyright">
       <name>Shaun McCance</name>
@@ -15,45 +15,24 @@
     <desc>Use larger fonts to make text easier to read.</desc>
   </info>
 
-  <title>Change text size</title>
+<title>Change text size on the screen</title>
 
-  <comment>
-    <cite date="2010-12-14" href="mailto:shaunm gnome org">Shaun McCance</cite>
-    <p>This assumes the reader knows how to.... By the end of this page,
-    the reader will be able to....</p>
-  </comment>
-   <note style="tip">
-   <p>
-    You can quickly adjust the text size by clicking on the blu and white universal access icon in the top panel, and selecting <gui>ON</gui> or <gui>OFF</gui> for <gui>Large Text</gui>.
-   </p>
-  </note>
-  <p>You can increase the size of the text displayed by following these steps:</p>
+<p>You can quickly adjust the text size by clicking on the universal access icon in the top panel, and selecting <gui>ON</gui> or <gui>OFF</gui> for <gui>Large Text</gui>.</p>
+   
+  <p>Alternatively, you can increase the size of the text by following these steps:</p>
 
   <steps>
     <item><p>Click on the universal access icon in the top panel.</p></item>
     <item><p>Click on <gui>Universal Access</gui>.</p></item>
     <item><p>Select the <gui>Seeing</gui> tab.</p> </item>
-    <item><p>Under <gui>Display</gui> select the <gui>Text size</gui> that best suits your needs from the drop down menu.  You can choose from:</p>
-<list>
-<item><p>Normal</p></item>
-<item><p>Large</p></item>
-<item><p>Larger</p></item>
-</list>
+    <item><p>Under <gui>Display</gui> select the <gui>Text size</gui> that is big enough for you. It will adjust immediately.</p>
 </item>
-    <item><p>The font size will adjust immediately.</p></item>
-    <item><p>Click on the <gui>x</gui> in the top right hand corner of the <gui>Universal Access</gui> window to close it.</p></item>
-  
   </steps>
 
-
  <note>
   <p>
     You can increase the text size at any time by clicking <keyseq><key>Shift</key><key>Ctrl</key><key>=</key></keyseq>.
   </p>
-<p>
-  To decrease the text size <keyseq><key>Ctrl</key><key>-</key></keyseq>.  
-</p>
  </note>
 
-
 </page>
diff --git a/gnome-help/C/a11y-locate-pointer.page b/gnome-help/C/a11y-locate-pointer.page
index 6e5f518..5da1f3a 100644
--- a/gnome-help/C/a11y-locate-pointer.page
+++ b/gnome-help/C/a11y-locate-pointer.page
@@ -4,7 +4,7 @@
   <info>
     <link type="guide" xref="a11y#vision" group="lowvision"/>
 
-    <revision pkgversion="3.0" date="2010-12-17" status="review"/>
+    <revision pkgversion="3.0" date="2011-03-30" status="final"/>
 
     <credit type="author copyright">
       <name>Shaun McCance</name>
@@ -17,21 +17,14 @@
 
   <title>Quickly locate the pointer</title>
 
-  <comment>
-    <cite date="2010-12-17" href="mailto:shaunm gnome org">Shaun McCance</cite>
-    <p>This assumes the reader knows how to.... By the end of this page,
-    the reader will be able to....</p>
-  </comment>
-
-  <p>If you have trouble seeing where the cursor is on your screen, you can set your system up to be able to simply press the <key>Ctrl</key> key to locate your pointer.  Once this is set up, pressing <key>Ctrl</key> will cause a black square to appeear briefly at the location of your pointer.</p>
-
 
+  <p>If you have trouble seeing where the mouse pointer is on your screen, you can make it so that simply pressing the <key>Ctrl</key> key will locate your pointer.  Once this is set up, pressing <key>Ctrl</key> will cause a black square to appear briefly at the location of your pointer.</p>
 
   <steps>
-    <item><p>Click on <gui>Activities</gui> and <gui>Type to search</gui> <input>mouse and touchpad</input>. Click on the <gui>Mouse and Touchpad</gui> icon to bring up the window.</p></item>
-    <item><p>Select the <gui>Mouse</gui> tab.</p></item>
-    <item><p>Under <gui>Locate Pointer</gui> click on the box next to <gui>Show position of pointer when the Control key is pressed.</gui></p></item>
+    <item><p>Click your name on the top panel and select <gui>System Settings</gui>.</p></item>
+    <item><p>Open <gui>Mouse and Touchpad</gui> and select the <gui>Mouse</gui> tab.</p></item>
+    <item><p>Check <gui>Show position of pointer when the Control key is pressed</gui>.</p></item>
 
   </steps>
-<p>Your <key>Ctrl</key> keys are now cursor locators.</p>
+<p>Your <key>Ctrl</key> keys will now locate the pointer when pressed.</p>
 </page>
diff --git a/gnome-help/C/a11y-mag.page b/gnome-help/C/a11y-mag.page
index fdc8a0a..96c9fd9 100644
--- a/gnome-help/C/a11y-mag.page
+++ b/gnome-help/C/a11y-mag.page
@@ -4,7 +4,7 @@
   <info>
     <link type="guide" xref="a11y#vision" group="lowvision"/>
 
-    <revision pkgversion="3.0" date="2010-12-14" status="review"/>
+    <revision pkgversion="3.0" date="2011-03-30" status="final"/>
 
     <credit type="author copyright">
       <name>Shaun McCance</name>
@@ -12,24 +12,18 @@
       <years>2010</years>
     </credit>
 
-    <desc>Zoom in on your screen.</desc>
+    <desc>Zoom in on your screen so it's easier to see things.</desc>
   </info>
 
   <title>Magnify the screen area</title>
 
-  <comment>
-    <cite date="2010-12-14" href="mailto:shaunm gnome org">Shaun McCance</cite>
-    <p>This assumes the reader knows how to.... By the end of this page,
-    the reader will be able to....</p>
-  </comment>
-
-  <p>This is not just enlarging the <link xref="a11y-font-size">text size</link>.  This feature truely magnifies your screen, allowing you to move around by zooming in on parts of the screen.</p>
+<p>Magnifying the screen is not just enlarging the <link xref="a11y-font-size">text size</link>.  This feature is like having a magnifying glass, allowing you to move around by zooming in on parts of the screen.</p>
 
   <steps>
-    <item><p>Click on the blue and white accessibility icon in the top panel.</p></item>
+    <item><p>Click on the universal access icon in the top panel.</p></item>
     <item><p>Turn <gui>Zoom</gui> <gui>ON</gui>.</p></item>
-    <item><p>Your screen area immediately becomes maginified.</p></item>
-    <item><p>You can now move around your screen area.  By moving your mouse to the edges of the screen, you will move the magnified area in different directions, allowing you to view your area of choice. </p></item>
+    <item><p>Part of the screen will immediately become maginified.</p></item>
+    <item><p>You can now move around the screen area. By moving your mouse to the edges of the screen, you will move the magnified area in different directions, allowing you to view your area of choice.</p></item>
   </steps>
 
 </page>
diff --git a/gnome-help/C/a11y.page b/gnome-help/C/a11y.page
index b9298d5..571e78f 100644
--- a/gnome-help/C/a11y.page
+++ b/gnome-help/C/a11y.page
@@ -4,7 +4,7 @@
   <info>
     <link type="guide" xref="index" group="a11y"/>
 
-    <revision pkgversion="3.0" date="2011-03-21" status="review"/>
+    <revision pkgversion="3.0" date="2011-03-30" status="final"/>
 
     <credit type="author copyright">
       <name>Shaun McCance</name>
@@ -23,7 +23,7 @@
 
   <title>Universal access</title>
 
-  <p>GNOME includes assistive technologies to support users with various
+  <p>The GNOME desktop includes assistive technologies to support users with various
   impairments and special needs, and to interact with common assistive
   devices. Many accessibility features can be accessed from the
   accessibility menu in the top bar.</p>
diff --git a/gnome-help/C/backup-frequency.page b/gnome-help/C/backup-frequency.page
index 68df01b..20b1377 100644
--- a/gnome-help/C/backup-frequency.page
+++ b/gnome-help/C/backup-frequency.page
@@ -5,7 +5,7 @@
   <info>
     <link type="guide" xref="files#backup"/>
     <desc>How often and when to backup your files.</desc>
-    <revision pkgversion="3.0" version="0.1" date="2011-02-26" status="review"/>
+    <revision pkgversion="3.0" version="0.1" date="2011-03-30" status="final"/>
     <credit type="author">
       <name>Tiffany Antopolski</name>
       <email>tiffany antopolski gmail com</email>
@@ -17,33 +17,23 @@
 
   </info>
 
-  <title>Frequency of backups</title>
-  <p>
-  The frequency of backups will depend on the type of data to be backed up.
-  </p>
-<p>
+<title>Frequency of backups</title>
 
+<p>How often you make backups will depend on the type of data to be backed up. For example, if you are running a network environment with critical data stored on your servers, then even nightly backups may not be enough.</p>
 
-For example, if you are running a network environment with critical data stored on your servers, then even nightly backups may not be enough.
-</p>
 <p>
 On the other hand, if you are backing up the data on your home computer then you may need to factor in a few things, such as:
 </p>
+
 <list>
-<item><p>
- The amount of time you spend on the computer.</p></item>
-<item><p>
- How often and by how much the data on the computer changes.</p></item>
+<item><p>The amount of time you spend on the computer.</p></item>
+<item><p>How often and by how much the data on the computer changes.</p></item>
 </list>
-<p>
 
-If it is just some music, e-mails and family photos, then weekly, monthly or even less frequent backups may suffice. However, if you happen to be in the middle of a tax audit, more frequent backups may be necessary.
+<p>
+If it is just some music, e-mails and family photos, then weekly or even monthly backups may suffice. However, if you happen to be in the middle of a tax audit, more frequent backups may be necessary.
 </p>
-  <comment>
-   <cite date="2010-06-29" href="mailto:gnome-doc-list gnome org">GNOME Documentation Project</cite>
-   <p>Explain how often the user should back up and why (there may be different frequencies for different types of data).</p>
-   <p>Explain that backups can be scheduled, and link to topics which explain how scheduling is done.</p>
-   <p>Will be a short topic.</p>
-  </comment>
+
+<p>As a general rule, the amount of time in between backups should be no more than the amount of time you could stand to spend re-doing any lost work. For example, if spending a week re-writing lost documents is too long for you, you should back-up at least once per week.</p>
 
 </page>
diff --git a/gnome-help/C/backup-restore.page b/gnome-help/C/backup-restore.page
index d190802..5a14518 100644
--- a/gnome-help/C/backup-restore.page
+++ b/gnome-help/C/backup-restore.page
@@ -3,8 +3,8 @@
 
   <info>
     <link type="guide" xref="files#backup"/>
-    <desc>Get your files back.</desc>
-    <revision pkgversion="3.0" version="0.1" date="2011-02-26" status="review"/>
+    <desc>Retrieve your files from a backup.</desc>
+    <revision pkgversion="3.0" date="2011-03-30" status="final"/>
     <credit type="author">
       <name>Tiffany Antopolski</name>
       <email>tiffany antopolski gmail com</email>
@@ -16,11 +16,14 @@
 
   </info>
 
-  <title>Restore a backup</title>
-   <p>
+<title>Restore a backup</title>
+
+<p>If something went wrong and you lost some files and documents, you can restore from a recent backup (if you have one).</p>
+
+<p>
 If you simply copied your files to a safe location, such as an external hard drive, another computer on the network or a  USB drive, you can <link xref="files-copy">copy them</link> back to your computer.
   </p>
   <p>
-If you used <app>Déjà Dup</app> to perform your backup, you should use <app>Déjà Dup</app> to restore your data from backup.  See <app>Déjà Dup</app> help.
+If you used <app>Déjà Dup</app> (or some other backup application) to perform your backup, you should use <app>Déjà Dup</app> to restore your data from backup too. See the help for Déjà Dup for more information.
   </p>
 </page>
diff --git a/gnome-help/C/backup-what.page b/gnome-help/C/backup-what.page
index 2395050..1448012 100644
--- a/gnome-help/C/backup-what.page
+++ b/gnome-help/C/backup-what.page
@@ -3,9 +3,9 @@
 
   <info>
     <link type="guide" xref="backup-why"/>
-    <desc></desc>
+    <desc>Backup anything that you can't bear to lose if something goes wrong.</desc>
     <title type="sort">b</title>
-    <revision pkgversion="3.0" version="0.1" date="2010-02-25" status="review"/>
+    <revision pkgversion="3.0" date="2011-03-30" status="final"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -27,12 +27,12 @@ Your priority should be to backup your <link xref="backup-thinkabout">most impor
 <terms>
  <item>
    <title>Your personal files </title>
-   <p>Documents, spreadsheets, email, calendar data, financial data, music, anything that you made that has importance to you. These are clearly the most important as they may be irreplaceable.</p>
+   <p>Documents, spreadsheets, email, calendar appointments, financial data, family photos, anything that you made that has importance to you. These are clearly the most important as they may be irreplaceable.</p>
     </item>
 
   <item>
   <title>Your personal settings</title>
-  <p> This includes changes you may have made to colours, backgrounds, screen resolution and mouse settings on your desktop. This also includes program preferences, such as settings for <app>LibreOffice</app>, your music player, and your email program. These are replaceable, but may take up valuable time to recreate.</p>
+  <p> This includes changes you may have made to colors, backgrounds, screen resolution and mouse settings on your desktop. This also includes application preferences, such as settings for <app>LibreOffice</app>, your music player, and your email program. These are replaceable, but may take a while to recreate.</p>
 </item>
 
 <item>
@@ -43,11 +43,11 @@ Your priority should be to backup your <link xref="backup-thinkabout">most impor
 
 <item>
 <title> Installed software (and everything else). </title>
-<p> Such software can usually be restored by reinstalling, but not always.</p>
+<p> Such software can usually be restored by reinstalling it.</p>
 </item>
 </terms>
 
     <p>
-    In general, you will want to backup files that are irreplaceable and files that require a great time investment to replace without a backup.  </p>
+    In general, you will want to backup files that are irreplaceable and files that require a great time investment to replace without a backup. If things are easy to replace, on the other hand, you may not want to use up disk space by having backups of them.</p>
 
 </page>
diff --git a/gnome-help/C/nautilus-file-properties-basic.page b/gnome-help/C/nautilus-file-properties-basic.page
index 472b9fa..f2eec39 100644
--- a/gnome-help/C/nautilus-file-properties-basic.page
+++ b/gnome-help/C/nautilus-file-properties-basic.page
@@ -22,7 +22,7 @@ revision pkgversion="3.0" version="0.1" date="2011-03-25" status="stub"/>
   <list>
    <item><p>Right click on the file, select <gui>Properties</gui>.</p></item>
    <item><p>Open the file and click on <guiseq><gui>File</gui><gui>Properties</gui></guiseq>.</p></item>
-   <item><p>Select the file in the <app>Files</app manager by clicking on it once.  Then press <guiseq><gui>Alt</gui><gui>Enter</gui></guiseq>.</p></item>
+   <item><p>Select the file in the <app>Files</app> manager by clicking on it once.  Then press <guiseq><gui>Alt</gui><gui>Enter</gui></guiseq>.</p></item>
   </list>
   <p>Select the <gui>Basic</gui> tab.</p>
 



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]