Help validation error fix and introduction review

2 files changed, 20 insertions, 16 deletions

diff --git a/help/C/introduction.page b/help/C/introduction.page
index 66880c7..803a072 100644
--- a/help/C/introduction.page
+++ b/help/C/introduction.page
@@ -4,7 +4,7 @@
 
   <info>
     <revision version="0.1" date="2011-12-19" status="stub"/>
-    <revision version="0.1" date="2011-12-20" status="review"/>
+    <revision pkgversion="3.4" date="2012-02-17" status="review"/>
     <link type="guide" xref="index" group="#first"/>
     <credit type="author copyright">
       <name>Julita Inca</name>
@@ -18,7 +18,7 @@
     </credit>
 
     <desc><app>Disk Usage Analyzer</app>, also referred to as
-    <app>baobab</app>, represents graphically how much disk space folders are consuming on your hard drive.</desc>
+    <app>baobab</app>, graphically represent your use of storage space.</desc>
   </info>
 
   <title>Introduction</title>
@@ -30,17 +30,21 @@
     Manager offers.</p>
   </comment>
 
-  <p><app>Baobab</app> can be used for checking how much disk space your files 
-  and folders take up. It uses <link xref="view-ring">charts</link> to show how 
-  much disk space is being used and you can see the remaining free space.</p>
-
-  <p><app>Baobab</app> lets you do this through
-  <link xref="scan-file-system">Scan filesystem</link>,
-  <link xref="scan-home">Scan Home</link>,
-  <link xref="scan-folder">Scan another folder on the system</link> or
-  <link xref="scan-remote">Scan a remote folder</link>.</p>
-
-  <p>The disk usage space taken up by each folder is not only useful to scan multiple internal hard drives.
-  It also works for external hard drives that are used by USB or cameras.</p>
+  <p><app>Disk Usage Analyzer</app> is a graphical, menu-driven application to
+  analyse disk usage. It can easily scan either the whole file system tree, or
+  a specific user-requested directory branch (local or remote). <app>Disk Usage
+  Analyzer</app> also auto-detects, in real time, any changes made to your home
+  directory. It provides a full graphical treemap window for each selected
+  folder and can be used for checking how much disk space your files and
+  folders take up using <link xref="view-ring">charts</link>.</p>
+
+  <p><app>Disk Usage Analyzer</app> lets you do this through scanning
+  <link xref="scan-file-system">the whole file system</link>,
+  <link xref="scan-home">your <file>Home</file></link>,
+  <link xref="scan-folder">any specific folder on the system</link> or
+  <link xref="scan-remote">a remote folder</link>.</p>
+
+  <p><app>Disk Usage Analyzer</app> can be used to scan multiple internal and
+  external storage devices, including hard disks, USB devices and cameras.</p>
 
 </page>
diff --git a/help/C/scan-home.page b/help/C/scan-home.page
index 4164592..f6df73c 100644
--- a/help/C/scan-home.page
+++ b/help/C/scan-home.page
@@ -49,8 +49,8 @@
   <p>To scan your <file>Home</file> folder, choose one of the following:</p>
   <list>
     <item><p>select <guiseq><gui>Analyzer</gui><gui>Scan Home
-    Folder</gui></guiseq> from the menu</p>.</item>
-    <item><p>click <gui>Scan Home</gui> in the toolbar</p>.</item>
+    Folder</gui></guiseq> from the menu.</p></item>
+    <item><p>click <gui>Scan Home</gui> in the toolbar.</p></item>
     <item><p>press <keyseq><key>CTRL</key><key>S</key></keyseq>.</p></item>
   </list>