GNOME.org
 

[gnome-user-docs/gnome-3-0] * Review topics; several significantly reworded * Fix validation errors

commit 1309e801a54f0295ef6005bdeeb8ee75c67471dc
Author: Phil Bull <philbull gmail com>
Date:   Wed Jun 8 03:40:03 2011 +0100

    * Review topics; several significantly reworded
    * Fix validation errors

 gnome-help/C/about-this-guide.page  |    7 ++--
 gnome-help/C/backup-frequency.page  |   18 +++++-----
 gnome-help/C/backup-thinkabout.page |   68 +++++++++++++----------------------
 gnome-help/C/backup-what.page       |   20 +++++-----
 gnome-help/C/backup-where.page      |   33 ++++++++---------
 gnome-help/C/backup-why.page        |   16 +++------
 gnome-help/C/disk-partitions.page   |   27 ++++++++------
 gnome-help/C/files-sort.page        |    8 ++--
 gnome-help/C/power-batterylife.page |    7 ++--
 9 files changed, 91 insertions(+), 113 deletions(-)
---
diff --git a/gnome-help/C/about-this-guide.page b/gnome-help/C/about-this-guide.page
index b09af12..59db2a0 100644
--- a/gnome-help/C/about-this-guide.page
+++ b/gnome-help/C/about-this-guide.page
@@ -5,9 +5,9 @@
 
   <info>
     <link type="guide" xref="more-help"/>
-    <desc>A few tips about using the desktop help guide.</desc>
+    <desc>A few tips on using the desktop help guide.</desc>
     <revision pkgversion="3.0" date="2011-04-04" status="final"/>
-    <revision pkgversion="3.0" version="3.0.1" date="2011-04-06" status="outdated"/>
+    <revision pkgversion="3.0" version="3.0.1" date="2011-06-07" status="final"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -17,8 +17,7 @@
   </info>
 
 <title>About this guide</title>
-<p>This guide is designed to describe the features of your desktop, answer your computing-related questions, and provide tips on using your computer more effectively.</p>
-<p>There are several features of the guide that we think make it easy to use.</p>
+<p>This guide is designed to give you a tour of the features of your desktop, answer your computer-related questions, and provide tips on using your computer more effectively.We've tried to make this guide as easy to use as possible:</p>
 
 <list>
   <item><p>The guide is sorted into small, task-oriented topics--not chapters. This means that you don't need to skim through an entire manual to find the answer to your questions.</p></item>
diff --git a/gnome-help/C/backup-frequency.page b/gnome-help/C/backup-frequency.page
index 45406bd..84820d1 100644
--- a/gnome-help/C/backup-frequency.page
+++ b/gnome-help/C/backup-frequency.page
@@ -1,12 +1,11 @@
 <page xmlns="http://projectmallard.org/1.0/";
-
       type="topic" id="backup-frequency">
 
   <info>
     <link type="guide" xref="files#backup"/>
-    <desc>How often and when to backup your files.</desc>
+    <desc>Learn how often your should backup your important files to make sure that they're safe.</desc>
     <revision pkgversion="3.0" date="2011-03-30" status="final"/>
-    <revision pkgversion="3.0" version="3.0.1" date="2011-04-06" status="outdated"/>
+    <revision pkgversion="3.0" version="3.0.1" date="2011-06-07" status="final"/>
     <credit type="author">
       <name>Tiffany Antopolski</name>
       <email>tiffany antopolski gmail com</email>
@@ -20,12 +19,13 @@
 
 <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>
+<p>How often you make backups will depend on the type of files to be backed up 
+and how important they are. For example, if you have the accounts for your 
+business stored on your computer, then even weekly backups may not be enough to 
+make sure you don't lose anything important.</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>
+<p>If you are backing-up files on your home computer, you may need to factor in 
+things like:</p>
 
 <list style="compact">
 <item><p>The amount of time you spend on the computer.</p></item>
@@ -33,7 +33,7 @@ On the other hand, if you are backing up the data on your home computer then you
 </list>
 
 <p>
-If the data you want to back up is lower priority or subject to few changes like music, e-mails and family photos, then 
+If the data you want to back up is lower priority or subject to few changes (like 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>
 
diff --git a/gnome-help/C/backup-thinkabout.page b/gnome-help/C/backup-thinkabout.page
index f74e6fa..4b9ed55 100644
--- a/gnome-help/C/backup-thinkabout.page
+++ b/gnome-help/C/backup-thinkabout.page
@@ -6,7 +6,7 @@
     <desc>A list of folders where you can find documents, files and settings that you may want to back up.</desc>
     
     <revision pkgversion="3.0" date="2011-04-03" status="final"/>
-    <revision pkgversion="3.0" version="3.0.1" date="2011-04-06" status="outdated"/>
+    <revision pkgversion="3.0" version="3.0.1" date="2011-06-07" status="final"/>
     <credit type="author">
       <name>Tiffany Antopolski</name>
       <email>tiffany antopolski gmail com</email>
@@ -22,54 +22,36 @@
   <title>Where can I find the files I want to back up?</title>
 
 <p>
-Deciding what files to back up and locating them is the most difficult step when attempting to perform a backup.
+Deciding which files to back up, and locating them, is the most difficult step when attempting to perform a backup.
 Listed below are the most common locations of important files and settings that you may want to back up.
 </p>
-<terms>
 
-<item>
-   <title>Your personal files and settings</title>
-<p>These are usually stored in your <file>Home</file> folder (<cmd>/home/your_name</cmd>). 
-They could be in subfolders such as <file>Desktop</file>, <file>Documents</file>, 
-<file>Pictures</file>, <file>Music</file>, <file>Videos</file> 
-and/or <file>.evolution</file> (for email). If your backup medium has 
-sufficient space, consider backing up the entire <cmd>/home</cmd> folder. 
-This is the simplest way.</p>
-
-<p>
-      If you are not able to backup all of <cmd>/home</cmd>, see below for a list of some 
-subfolders of the <cmd>/home</cmd> folder to check for important files.
-</p>
-<note>
 <list>
-<item><p><cmd>~/</cmd> represents your home folder <cmd>/home/your_name</cmd> </p></item>
+ <item>
+  <p>Personal files (documents, music, photos and videos)</p>
+  <p>These are usually stored in your <file>Home</file> folder (<cmd>/home/your_name</cmd>). 
+They could be in subfolders such as <file>Desktop</file>, <file>Documents</file>, 
+<file>Pictures</file>, <file>Music</file> and <file>Videos</file>.</p>
+  <p>If your backup medium has sufficient space (if it's an external hard disk, for example), consider backing up the entire Home folder. You can find out how much disk space your Home folder takes up by using the <app>Disk Usage Analyzer</app>.</p>
+ </item>
 
- <item><p>Any file or folder name that starts with a period is hidden by default. 
+ <item>
+  <p>Hidden files</p>
+  <p>Any file or folder name that starts with a period (.) is hidden by default. 
 To view hidden files, click <guiseq><gui>View</gui><gui>Show Hidden Files</gui></guiseq> or 
-press <keyseq><key>Ctrl</key><key>H</key></keyseq>.
-</p></item>
+press <keyseq><key>Ctrl</key><key>H</key></keyseq>. You can copy these to a backup location like any other file.</p>
+ </item>
+
+ <item>
+  <p>Personal settings (desktop preferences, themes, and software settings)</p>
+  <p>Most applications store their settings in hidden folders inside your Home folder (see above for information on hidden files).</p>
+  <p>Most of your application settings will be stored in the hidden folders <cmd>.config</cmd>, <cmd>.gconf</cmd>, <cmd>.gnome3</cmd>, and <cmd>.local</cmd> in your Home folder.</p>
+ </item>
+ 
+ <item>
+  <p>System-wide settings</p>
+  <p>Settings for important parts of the system aren't stored in your Home folder. There are a number of locations that they could be stored, but most are stored in the <file>/etc</file> folder. In general, you won't need to back-up these files on a home computer. If you are running a server, however, you should back up the files for the services that it is running.</p>
+ </item>
 </list>
-</note>
-</item>
-</terms>
-
-<table shade="rows">
-  <tr>
-    <td><p>Your personal files</p></td><td><p><cmd>~/</cmd>, <cmd>~/Desktop</cmd>, 
-<cmd>~/Documents</cmd>, <cmd>~/Pictures</cmd>, <cmd>~/Music</cmd>, <cmd>Videos</cmd>, <cmd>~/bin</cmd>, 
-and others</p></td> <td><p> Contain files you actively created.</p></td>
-
-  </tr>
-  <tr>
-    <td><p>Your personal settings</p></td> <td><p><cmd>~/.config</cmd>, <cmd>~/.gconf</cmd>, 
-<cmd>~/.gnome3</cmd>, <cmd>~/.local</cmd></p></td>
-    <td><p>Contain your settings for the desktop and some applications.</p></td>
-  </tr>
-  <tr>
-    <td><p>System settings</p></td> <td><p><cmd>/etc</cmd> located in the File System outside of your Home folder.</p></td>
-    <td><p>Your system settings.  In general, you don't need to go outside of your Home folder.</p></td>
-  </tr>
-
-</table>
 
 </page>
diff --git a/gnome-help/C/backup-what.page b/gnome-help/C/backup-what.page
index 5e00802..8f65d9f 100644
--- a/gnome-help/C/backup-what.page
+++ b/gnome-help/C/backup-what.page
@@ -5,7 +5,7 @@
     <link type="guide" xref="backup-why"/>
     <desc>Back up anything that you can't bear to lose if something goes wrong.</desc>
     <revision pkgversion="3.0" date="2011-03-30" status="final"/>
-    <revision pkgversion="3.0" version="3.0.1" date="2011-04-06" status="outdated"/>
+    <revision pkgversion="3.0" version="3.0.1" date="2011-06-07" status="final"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -27,7 +27,7 @@ well as those that are difficult to recreate.  An example, ranked from most impo
 
 <terms>
  <item>
-   <title>Your personal files </title>
+   <title>Your personal files</title>
    <p>This may include documents, spreadsheets, email, calendar appointments, financial data, family photos, 
 or any other personal files that you would consider irreplaceable.</p>
     </item>
@@ -42,20 +42,20 @@ but may take a while to recreate.</p>
 
 <item>
 <title>System settings</title>
-<p>Most people never change the settings that are created during installation. 
-If you do customize your system, you may wish to backup these settings.
+<p>Most people never change the system settings that are created during installation. 
+If you do customize your system settings for some reason, or if you use your computer as a server, then you may wish to backup these settings.
 </p>
 </item>
 
 <item>
-<title> Installed software (and everything else). </title>
-<p> Such software can usually be restored by reinstalling it.</p>
+<title>Installed software</title>
+<p>The software you use can normally be restored quite quickly after a serious computer problem, 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. 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>
+<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/backup-where.page b/gnome-help/C/backup-where.page
index 2b5e350..7a3ecc7 100644
--- a/gnome-help/C/backup-where.page
+++ b/gnome-help/C/backup-where.page
@@ -3,10 +3,10 @@
 
   <info>
     <link type="guide" xref="backup-why"/>
-    <desc>Advice on where to store your backups and what storage device to use.</desc>
+    <desc>Advice on where to store your backups and what type of storage device to use.</desc>
     <title type="sort">c</title>
     <revision pkgversion="3.0" date="2011-04-03" status="final"/>
-    <revision pkgversion="3.0" version="3.0.1" date="2011-04-06" status="outdated"/>
+    <revision pkgversion="3.0" version="3.0.1" date="2011-06-07" status="final"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -18,36 +18,35 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>Where to store your backup</title>
-    <p>
-    You should store backup copies of your files somewhere separate from your computer (on an external hard disk, for example). An important consideration when choosing the backup medium is capacity. This will depend on how much data you need to back up.
-    </p>
+<title>Where to store your backup</title>
+<p>You should store backup copies of your files somewhere separate from your computer - on an external hard disk, for example. That way, if the computer breaks, the backup will still be intact. For maximum security, you shouldn't keep the backup in the same building as your computer. If there is a fire or theft, both copies of the data could be lost if they are kept together.</p>
+    
+<p>It is important to choose an appropriate <em>backup medium</em> too. You need to store your backups on a device that has sufficient disk capacity for all of the backed-up files.</p>
 
-   <list>
+   <list style="compact">
     <title>Local and remote storage options</title>
     <item>
-      <p>A USB memory key (low capacity)</p>
+      <p>USB memory key (low capacity)</p>
     </item>
     <item>
-      <p>An internal disk drive (higher capacity)</p>
+      <p>Internal disk drive (high capacity)</p>
     </item>
     <item>
-      <p>An external USB drive (variable capacity, but can be very high)</p>
+      <p>External hard disk (typically high capacity)</p>
     </item>
     <item>
-      <p>A network drive (high capacity)</p>
+      <p>Network-connected drive (high capacity)</p>
     </item>
     <item>
-      <p>A file/backup server</p>
+      <p>File/backup server (high capacity)</p>
     </item>
     <item>
-     <p>Writable CDs or DVDs</p>
+     <p>Writable CDs or DVDs (low/medium capacity)</p>
     </item>
     <item>
-     <p>An online backup service like <link href = "http://aws.amazon.com/s3/";>Amazon S3</link> or <link href="https://one.ubuntu.com/";>Ubuntu One</link> (stores your data off-site for a small fee)</p>
+     <p>Online backup service (<link href = "http://aws.amazon.com/s3/";>Amazon S3</link> or <link href="https://one.ubuntu.com/";>Ubuntu One</link>, for example; capacity depends on price)</p>
     </item>
    </list>
-<p>
-Some of these would allow for a backup of every file on your system, also known as a <em>complete system backup</em>.
-</p>
+   
+<p>Some of these options have sufficient capacity to allow for a backup of every file on your system, also known as a <em>complete system backup</em>.</p>
 </page>
diff --git a/gnome-help/C/backup-why.page b/gnome-help/C/backup-why.page
index dcee19f..8a041f0 100644
--- a/gnome-help/C/backup-why.page
+++ b/gnome-help/C/backup-why.page
@@ -22,19 +22,13 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>Back up your important files</title>
+<title>Back up your important files</title>
 
-  <p><em>Backing up</em> your files simply means making a copy of your files for 
-safekeeping. This is done in case you lose your original files, or the files 
-become corrupted. If that happens, your copies can be used to restore the 
-original data.</p>
+<p><em>Backing up</em> your files simply means making a copy of them for safekeeping.
+This is done in case the original files become unusable due to loss or corruption. These copies can be used to restore the original data in the event of loss. Copies should be stored on a different device from the original files. For example, you may use a USB drive, an external hard drive, a CD/DVD, or an off-site service.
+</p>
 
-  <p>Copies should be stored on a different device from the original files. For 
-example, you may use a USB drive, an external hard drive, a CD/DVD, or an 
-off-site service.</p>
-
-<p>The best way to back up up your files is to do so regularly, keeping the 
-copies off-site and encrypted.</p>
+<p>The best way to back up up your files is to do so regularly, keeping the copies off-site and (possibly) encrypted.</p>
 
 <links type="topic" style="2column"/>
 
diff --git a/gnome-help/C/disk-partitions.page b/gnome-help/C/disk-partitions.page
index c34272e..fb4ad61 100644
--- a/gnome-help/C/disk-partitions.page
+++ b/gnome-help/C/disk-partitions.page
@@ -5,39 +5,44 @@
     <link type="guide" xref="hardware#disk"/>
 
     <revision pkgversion="3.0" date="2011-04-04" status="final"/>
-    <revision pkgversion="3.0" version="3.0.1" date="2011-04-06" status="outdated"/>
+    <revision pkgversion="3.0" version="3.0.1" date="2011-06-07" status="final"/>
     
     <credit type="author">
       <name>GNOME Documentation Team</name>
       <email>gnome-doc-list gnome org</email>
     </credit>
    
-    <desc>Understand what volumes and partitions are and use the
-    disk utility application.</desc>
+    <desc>Understand what volumes and partitions are and use the disk utility 
+    to manage them.</desc>
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
 <title>Manage volumes and partitions</title>
 
-<p>The word <em>volume</em> is used to describe areas of storage that your computer has made available for your use. The computer makes this storage accessible via your file system in a process referred to as <em>mounting</em>. Mounted volumes may be hard drives, USB drives, DVD-RWs, SD cards, and other media.</p>
+<p>The word <em>volume</em> is used to describe a storage device, like a hard disk. It can also refer to a <em>part</em> of the storage on that device, because you can split the storage up into chunks. The computer makes this storage accessible via your file system in a process referred to as <em>mounting</em>. Mounted volumes may be hard drives, USB drives, DVD-RWs, SD cards, and other media. If a volume is currently mounted, you can read (and possibly write) files on it.</p>
 
-<p>Often, a mounted volume is called a <em>partition</em>, though they are not identical. "Partition" refers to one or more <em>physical</em> areas of storage on a single drive. Once a partition has been mounted, it can be called a volume. You can think of volumes as the labeled, accessible â??storefrontsâ?? to the functional â??back roomsâ?? of partitions and drives.</p>
+<p>Often, a mounted volume is called a <em>partition</em>, though they are not necessarily the same thing. A â??partitionâ?? refers to a <em>physical</em> area of storage on a single disk drive. Once a partition has been mounted, it can be referred to as a volume because you can access the files on it. You can think of volumes as the labeled, accessible â??storefrontsâ?? to the functional â??back roomsâ?? of partitions and drives.</p>
 
+<section id="manage">
+ <title>View and manage volumes and partitions using the disk utility</title>
+ <p>You can check and modify your computer's storage volumes with the disk utility.</p>
 <steps>
-  <title>View and manage volumes and partitions using <app>Disk Utility</app></title>
  <item>
-  <p>Go to <gui>Activities</gui> in the top left corner of the screen and start the <app>Disk Utility</app>.</p>
+  <p>Open the <gui>Activities</gui> overview and start the <app>Disk Utility</app>.</p>
  </item>
  <item>
-  <p> In the pane marked <gui>Storage Devices</gui>, you will find hard disks, CD/DVD drives, and other physical devices. Click on a device of interest.</p>
+  <p> In the pane marked <gui>Storage Devices</gui>, you will find hard disks, CD/DVD drives, and other physical devices. Click on the device you want to inspect.</p>
  </item>
  <item>
- <p> In the right pane, the area labeled <gui>Volumes</gui> provides a visual breakdown of the volumes and partitions present on the selected device. It also contains a variety of tools used to manage these volumes. Be careful, it is possible to completely erase the data on your disk with these utilities.</p>
+ <p> In the right pane, the area labeled <gui>Volumes</gui> provides a visual breakdown of the volumes and partitions present on the selected device. It also contains a variety of tools used to manage these volumes.</p>
+ <p>Take care; it is possible to completely erase the data on your disk with these tools if you try to.</p>
 </item>
 </steps>
 
-<p>Your computer most likely has at least one <em>primary</em> partition and a single <em>swap</em> partition. The swap partition is used by your operating system for memory management, and is rarely mounted.  The primary partition contains your operating system, applications, settings, and personal files. These files can be distributed among multiple partitions for security or convenience.</p>
+<p>Your computer most likely has at least one <em>primary</em> partition and a single <em>swap</em> partition. The swap partition is used by the operating system for memory management, and is rarely mounted.  The primary partition contains your operating system, applications, settings, and personal files. These files can also be distributed among multiple partitions for security or convenience.</p>
 
-<p>One primary partition must contain information that your computer uses to start up, or <em>boot</em>. For this reason it is sometimes called a boot partition, or boot volume. To determine if a volume is bootable, look for <gui>Partition Flags</gui> in <gui>Disk Utility</gui>. External media such as USB drives and CDs may also contain a bootable volume.</p>
+<p>One primary partition must contain information that your computer uses to start up, or <em>boot</em>. For this reason it is sometimes called a boot partition, or boot volume. To determine if a volume is bootable, look at its <gui>Partition Flags</gui> in the disk utility. External media such as USB drives and CDs may also contain a bootable volume.</p>
+
+</section>
 
 </page>
diff --git a/gnome-help/C/files-sort.page b/gnome-help/C/files-sort.page
index fc6fd3f..d263b27 100644
--- a/gnome-help/C/files-sort.page
+++ b/gnome-help/C/files-sort.page
@@ -17,6 +17,10 @@
 
 <title>Sort files and folders</title>
 
+<comment>
+ <p>May benefit from figures illustrating the different views.</p>
+</comment>
+
 <p>You can sort files in different ways in a folder, for example by sorting them in order of date or file size. See <link xref="#ways"/> below for a list of common ways to sort files.</p>
 
 <p>When you change how items are sorted in a folder, it only affects that folder. The file
@@ -69,8 +73,4 @@ You can change the current view using the <gui>View</gui> menu.</p>
  </terms>
 </section>
 
-<comment>
- <p>May benefit from figures illustrating the different views.</p>
-</comment>
-
 </page>
diff --git a/gnome-help/C/power-batterylife.page b/gnome-help/C/power-batterylife.page
index 2a54daf..6cb9387 100644
--- a/gnome-help/C/power-batterylife.page
+++ b/gnome-help/C/power-batterylife.page
@@ -1,6 +1,5 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic"
-      style="tip"
+      type="topic" style="tip"
       id="power-batterylife">
 
   <info>
@@ -28,9 +27,9 @@
 <p>Computers can use a lot of power. By using some simple energy-saving strategies, you can reduce your energy bill and help the environment. If you have a laptop, this will also help to increase the amount of time it can run on battery for.</p>
 
 <section id="general">
- <list>
+ 
  <title>General tips</title>
-
+ <list>
   <item>
    <p><link xref="shell-exit#suspend">Suspend your computer</link> when you are not using it. This significantly reduces the amount of power it uses, and it can be woken up very quickly.</p>
   </item>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]