GNOME.org
 

[baobab/mallard-documentation: 3/27] Second pass at user help

commit c3ae4782faf682fe71ddde8b157c61407f10b4f3
Author: Julita Inca <yrazes gmail com>
Date:   Wed Dec 21 00:56:46 2011 -0500

    Second pass at user help

 help/C/allocated-space.page  |    2 +-
 help/C/introduction.page     |    2 +-
 help/C/scan-file-system.page |   82 ++++++++++++++++++++----------------------
 help/C/scan-folder.page      |   74 +++++++++++++++++--------------------
 help/C/scan-home.page        |   14 +++----
 help/C/scan-remote.page      |   11 +++---
 help/C/tool-status-bar.page  |    2 +-
 help/C/view-rings.page       |    2 +-
 help/C/view-tree.page        |    2 +-
 9 files changed, 90 insertions(+), 101 deletions(-)
---
diff --git a/help/C/allocated-space.page b/help/C/allocated-space.page
index d6c8500..14ad421 100644
--- a/help/C/allocated-space.page
+++ b/help/C/allocated-space.page
@@ -3,7 +3,7 @@
       id="allocated-space">
   <info>
     <revision version="0.1" date="2011-12-19" status="stub"/>
-    <link type="guide" xref="index#preferences"/>
+    <link type="guide" xref="index#preferences" group="#last"/>
     <credit type="author copyright">
       <name>Julita Inca</name>
       <email>yrazes gmail com</email>
diff --git a/help/C/introduction.page b/help/C/introduction.page
index ec5402c..994d28d 100644
--- a/help/C/introduction.page
+++ b/help/C/introduction.page
@@ -18,7 +18,7 @@
     </credit>
 
     <desc><app>Disk Usage Analyzer</app>, also referred to as
-    <app>baobab</app>, is a graphical file system scanner.</desc>
+    <app>baobab</app>, represents graphically how much disk space folders are consuming on your hard drive.</desc>
   </info>
 
   <title>Introduction</title>
diff --git a/help/C/scan-file-system.page b/help/C/scan-file-system.page
index 138db3c..5d92e08 100644
--- a/help/C/scan-file-system.page
+++ b/help/C/scan-file-system.page
@@ -3,7 +3,7 @@
       id="scan-file-system">
   <info>
     <revision version="0.1" date="2011-12-19" status="stub"/>
-    <link type="guide" xref="index#scan"/>
+    <link type="guide" xref="index#scan" group="#first"/>
     <credit type="author copyright">
       <name>Julita Inca</name>
       <email>yrazes gmail com</email>
@@ -14,47 +14,43 @@
 
    </info>
 
-      <title>Scan filesystem</title>
-
-        <comment><cite date="2011-12-19" href="mailto:yrazes gmail com">Julita Inca</cite>
-	<p>This assumes the reader knows what are the folders that belongs to the file system. 
-	By the end of this page, the reader will be able to scan a full file system.</p></comment>
-
-	<p>Maybe you got a warning message saying âLow Disk Spaceâ while you are trying to    
-	download an application or while you trying to create or to copy a folder, and you 
-	do not know which are the folders or programs that are taking up most space in your hard disk. 
-	You can use Scan File system because it provides you a visual representation of the capacity 
-	and usage of every single folder that your hard disk has.</p>
-
-
-	<p>You can scan filesystem, by doing one of these alternatives:</p>
-
-	<list>
-		<item><p>Click <gui>Scan filesystem</gui>. </p>
-	              <p>Choose the second button that has the form of the disk icon, next to the <gui>Scan Home</gui> icon.</p></item>
-		<item><p>Select from the menu, <guiseq><gui>Analyzer</gui>
-	              <gui>Scan filesystem</gui></guiseq>.</p></item>
-		<item><p>Press <key>CTRL</key> + <key>F</key>.</p></item>
-	</list>
-
-	<p><app>Disk Usage Analyzer</app> will display sizes in the directory tree as <link xref="allocated-space"> 
-	allocted space</link>. This means that the displayed sizes refer to the actual disk usage and not 
-	to the apparent directory size. If you want to view the apparent file size, uncheck <guiseq><gui>View</gui>
-	<gui>Allocated Space</gui></guiseq>.</p>
-
-	<p>As soon as you get the results, you can decide which applications could be uninstalled, 
-	or which folders can be <link href="help:gnome-help/files-delete">deleted</link> or 
-	<link href="help:gnome-help/files-copy">moved</link>.</p>
-
-	<p>If you organized folders or delete them, and still don't have any space in your <gui>Home folder</gui>, 
-	you can do a <link href="help:gnome-help/backup-how">backup</link> of your information. 
-	If you need another disk, you have to ask a specialist to do that.</p>
-
-	<note style="tip">
-	       <p>Click <gui>Stop Scanning</gui>, the circle red icon, to cancel this process.</p>
-	       <p>Click <gui>Refresh</gui> to update the scanning process.</p>
-	</note> 
-
-	<p><media type="image" src="figures/scan-file-system.png" width="532" height="335"/></p>
+   <title>Scan filesystem</title>
+
+   <comment><cite date="2011-12-19" href="mailto:yrazes gmail com">Julita Inca</cite>
+   <p>This assumes the reader knows what are the folders that belongs to the file system. 
+   By the end of this page, the reader will be able to scan a full file system.</p></comment>
+   
+   <p>Maybe you got a warning message saying âLow Disk Spaceâ while you are trying to    
+   download an application or while you trying to create or to copy a folder, and you 
+   do not know which are the folders or programs that are taking up most space in your hard disk. 
+   You can use Scan File system because it provides you a visual representation of the capacity 
+   and usage of every single folder that your hard disk has.</p>
+
+   <p>You can scan filesystem, by doing one of these alternatives:</p>
+   <list>
+     <item><p>Select <guiseq><gui>Analyzer</gui><gui>Scan filesystem</gui></guiseq> from the menu.</p></item>
+     <item><p>Click <gui>Scan filesystem</gui> in the toolbar.</p></item>
+     <item><p>Press <keyseq><key>CTRL</key><key>F</key></keyseq>.</p></item>
+   </list>
+
+  <note style="advanced">
+    <p><app>Disk Usage Analyzer</app> will display sizes in the directory tree as 
+    <link xref="allocated-space">allocted space</link>. 
+    This means that the displayed sizes refer to the actual disk usage and not 
+    to the apparent directory size.</p>
+  </note>
+
+  <p>The results may be useful in deciding which folders compress, which applications to uninstall, 
+  or which folders can be
+  <link href="help:gnome-help/files-delete">deleted</link> or
+  <link href="help:gnome-help/files-copy">moved</link>, to free up space on the
+  hard disk. You can also use them to estimate how much space would be needed
+  for a <link href="help:gnome-help/backup-how">backup</link> of your
+  <file>File System</file> directory.</p>
+
+  <note style="tip">
+    <p>Click the <gui>Stop</gui> in the toolbar to cancel the current, or <gui>Refresh</gui> 
+    to repeat the last scan.</p>
+  </note> 
 
 </page>
diff --git a/help/C/scan-folder.page b/help/C/scan-folder.page
index 8780474..236bb5a 100644
--- a/help/C/scan-folder.page
+++ b/help/C/scan-folder.page
@@ -12,45 +12,39 @@
 
     <desc>Customize scanning in home folder, on external devices, on folder servers, and across your computer's file system.</desc>
 
-   </info>
-
-     <title>Scan a folder</title>
-
-     <comment><cite date="2011-12-19" href="mailto:yrazes gmail com">Julita Inca</cite>
-     <p>This assumes the reader knows how to use the nautilus to browse folders. 
-     By the end of this page, the reader will be able to scan any folder inside your home, 
-     on external devices or across the computer.</p></comment>
-
-     <p>If you have many folders inside one, and maybe you want to reorganize all the structure 
-     of this folder because it is too big or quite older, or maybe you are doing some maintainer 
-     job to make your system run smoothly; you probably need to know what are the heaviest folders 
-     that the folder has (folder in your home folder, on external devices, on folder servers,
-     and across your computer's file system).</p>
-
-     <p>You can scan a folder by doing one of these alternatives:</p>
-
-     <list>
-	<item><p>Click <gui>Scan a folder</gui>.</p> 
-	      <p>Choose the third button that has the form of a folder icon, next to the <gui>Scan filesytem </gui>.</p></item>
-	<item><p>Select from the menu, <guiseq><gui>Analyzer</gui>
-	      <gui>Scan Folder</gui></guiseq>.</p></item>
-	<item><p>Press <key>CTRL</key> + <key>O</key>.</p></item>
-     </list>
-
-	<p>Then, select the folder you want to scan by clicking on it once, and click       
-	<gui>Open</gui> to start the scanning process.</p>
-
-	<p>As soon as you get the results, you can decide which applications could be uninstalled, 
-	or which folders can be <link href="help:gnome-help/files-delete">deleted</link> or 
-	<link href="help:gnome-help/files-copy">moved</link>.</p>
-
-	<p>If you organized folders or delete them, and still don't have any space in your <gui>Home folder</gui>, 
-	you can do a <link href="help:gnome-help/backup-how">backup</link> of your information. 
-	If you need another disk, you have to ask a specialist to do that.</p>
-
-	<note style="tip">
-	  <p>Click <gui>Stop Scanning</gui> the circle red icon, to cancel this process.</p>
-       	  <p>Click <gui>Refresh</gui> to update the scanning process.</p>
-	</note> 
+  </info>
+
+  <title>Scan a folder</title>
+
+  <comment><cite date="2011-12-19" href="mailto:yrazes gmail com">Julita Inca</cite>
+  <p>This assumes the reader knows how to use the nautilus to browse folders. 
+  By the end of this page, the reader will be able to scan any folder inside your home, 
+  on external devices or across the computer.</p></comment>
+
+  <p>If you have many folders inside one, and maybe you want to reorganize all the structure 
+  of this folder because it is too big or quite older, or maybe you are doing some maintainer 
+  job to make your system run smoothly; you probably need to know what are the heaviest folders 
+  that the folder has (folder in your home folder, on external devices, on folder servers,
+  and across your computer's file system).</p>
+
+  <p>You can scan a folder by doing one of these alternatives:</p>
+
+  <list>
+     <item><p>Select <guiseq><gui>Analyzer</gui><gui>Scan Folder</gui></guiseq> from the menu.</p></item>
+     <item><p>Click <gui>Scan a folder</gui> in the toolbar.</p></item>
+     <item><p>Press <keyseq><key>CTRL</key><key>O</key></keyseq>.</p></item>
+  </list>
+
+  <p>The results may be useful in deciding which folders compress, which applications to uninstall, 
+  or which folders can be
+  <link href="help:gnome-help/files-delete">deleted</link> or
+  <link href="help:gnome-help/files-copy">moved</link>, to free up space on the
+  hard disk. You can also use them to estimate how much space would be needed
+  for a <link href="help:gnome-help/backup-how">backup</link> of your
+  <file>folder</file>.</p>
+
+  <note style="tip">
+    <p>Click the <gui>Stop</gui> in the toolbar to cancel the current, or <gui>Refresh</gui> to repeat the last scan.</p>
+  </note> 
 
 </page>
diff --git a/help/C/scan-home.page b/help/C/scan-home.page
index c090930..82ad56a 100644
--- a/help/C/scan-home.page
+++ b/help/C/scan-home.page
@@ -50,13 +50,13 @@
   <p>To scan your <file>Home</file> folder:</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>
-    <item><p>Press <keyseq><key>CTRL</key><key>S</key></keyseq></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>
 
-  <p>The results may be useful in deciding which applications to uninstall, or
-  which folders can be
+  <p>The results may be useful in deciding which folders compress, which applications to uninstall, 
+  or which folders can be
   <link href="help:gnome-help/files-delete">deleted</link> or
   <link href="help:gnome-help/files-copy">moved</link>, to free up space on the
   hard disk. You can also use them to estimate how much space would be needed
@@ -64,9 +64,7 @@
   <file>Home</file> directory.</p>
 
   <note style="tip">
-    <p>Click the <gui>Stop</gui> button in the toolbar to cancel the current
-    scan.</p>
-    <p>Click <gui>Refresh</gui> to repeat the last scan.</p>
+    <p>Click the <gui>Stop</gui> in the toolbar to cancel the current, or <gui>Refresh</gui> to repeat the last scan.</p>
   </note> 
 
 </page>
diff --git a/help/C/scan-remote.page b/help/C/scan-remote.page
index bf82378..d492cb3 100644
--- a/help/C/scan-remote.page
+++ b/help/C/scan-remote.page
@@ -3,14 +3,14 @@
       id="scan-remote">
   <info>
     <revision version="0.1" date="2011-12-19" status="stub"/>
-    <link type="guide" xref="index#scan"/>
+    <link type="guide" xref="index#scan" group="#last"/>
     <credit type="author copyright">
       <name>Julita Inca</name>
       <email>yrazes gmail com</email>
       <years>2011</years>
     </credit>
 
-    <desc>Scan folders from wherever you are from other laptop or desktop.</desc>
+    <desc>Scan folders from wherever you are from other computer.</desc>
   </info>
 
     <title>Scan Remote Folder</title>
@@ -19,9 +19,10 @@
     <p>This assumes the reader knows when to use the communication protocols. 
     By the end of this page, the reader will be able to scan remote folders.</p></comment>
 
-    <p>If you need to scan a remote folder, click <gui>Scan Remote Folder</gui>
-    or select from the menu <guiseq><gui>Analyzer</gui><gui>Scan Remote Folder</gui></guiseq>. </p>
-    <p><app>Disk Usage Analyzer</app> can connect to a server specifying the protocol explicitly:</p>
+   <p>You can scan remote folders by selecting <guiseq><gui>Analyzer</gui><gui>Scan Remote Folder</gui></guiseq> from the menu,
+    or by clicking <gui>Scan a remote folder</gui> in the toolbar.</p>
+
+   <p>Choose one of these protocols to start the scanning process:</p>
 
   <list>
 	<item><p><link xref="ssh"><gui>SSH</gui></link> is an acronym for Secure Shell.  
diff --git a/help/C/tool-status-bar.page b/help/C/tool-status-bar.page
index 7b044e1..a444391 100644
--- a/help/C/tool-status-bar.page
+++ b/help/C/tool-status-bar.page
@@ -3,7 +3,7 @@
       id="tool-status-bar">
   <info>
     <revision version="0.1" date="2011-12-19" status="stub"/>
-    <link type="guide" xref="index#preferences"/>
+    <link type="guide" xref="index#preferences"  group="#last"/>
     <credit type="author copyright">
       <name>Julita Inca</name>
       <email>yrazes gmail com</email>
diff --git a/help/C/view-rings.page b/help/C/view-rings.page
index 3a35d67..bbf4561 100644
--- a/help/C/view-rings.page
+++ b/help/C/view-rings.page
@@ -3,7 +3,7 @@
       id="view-rings">
   <info>
     <revision version="0.1" date="2011-12-19" status="stub"/>
-    <link type="guide" xref="index#preferences"/>
+    <link type="guide" xref="index#preferences" group="#first"/>
     <credit type="author copyright">
       <name>Julita Inca</name>
       <email>yrazes gmail com</email>
diff --git a/help/C/view-tree.page b/help/C/view-tree.page
index 8a4f030..4754fe8 100644
--- a/help/C/view-tree.page
+++ b/help/C/view-tree.page
@@ -13,7 +13,7 @@
     <desc>View the results of the scanning in graphical way as rectangles chart grouped in a form like tree.</desc>
   </info>
 
-  <title>View as Rings Chart</title>
+  <title>View as Treemap Chart</title>
 
   <comment><cite date="2011-12-19" href="mailto:yrazes gmail com">Julita Inca</cite>
   <p>This assumes the reader knows how to scan any particular folder.
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]