[gnome-user-docs] Write a disk- stub, make a basic start on another

[Phil Bull <philbull src gnome org>]

commit 631046b0ba16e60818fd8007d09039501e3ceca1
Author: Phil Bull <philbull gmail com>
Date:   Thu Mar 31 22:10:47 2011 +0100

    Write a disk- stub, make a basic start on another

 gnome-help/C/disk-format.page     |   35 +++++++++++++++++++++++++++++++----
 gnome-help/C/disk-partitions.page |   10 ++++++----
 2 files changed, 37 insertions(+), 8 deletions(-)
---
diff --git a/gnome-help/C/disk-format.page b/gnome-help/C/disk-format.page
index 5efcf2d..2c4dc46 100644
--- a/gnome-help/C/disk-format.page
+++ b/gnome-help/C/disk-format.page
@@ -4,7 +4,7 @@
   <info>
     <link type="guide" xref="hardware#disk"/>
 
-    <revision pkgversion="3.0" date="2011-03-22" status="stub"/>
+    <revision pkgversion="3.0" date="2011-03-31" status="review"/>
     
     <credit type="author">
       <name>GNOME Documentation Team</name>
@@ -16,8 +16,35 @@
 
 <title>Wipe everything off a removable disk</title>
 
-<comment>
- <p>Use palimpsest to format a disk. Remember to tell the user that this is dangerous and wipes everything! Reasons why you might want to format a disk.</p>
-</comment>
+<p>If you have a removable disk like a USB memory stick or an external hard disk, you may wish to completely remove all of the files you have on there. You can do this by <em>formatting</em> the disk - this deletes all of the files on the disk and leaves it empty.</p>
+
+<steps>
+ <item>
+  <p>Go to the <gui>Activities</gui> overview and open the <app>Disk Utility</app>.</p>
+ </item>
+ 
+ <item>
+  <p>Find the disk you want to wipe in the list on the left side of the window and click to select it.</p>
+  <p><em>Make sure that you have selected the correct disk! If you choose the wrong disk, all of the files on the other disk will be deleted!</em></p>
+ </item>
+ 
+ <item>
+  <p>In the window that pops up, choose a <gui>Type</gui> for the disk. This chooses what is known as the <em>filesystem type</em>.<p>
+  <p>If you want to use the disk on Windows and Mac OS computers as well as Linux, choose <gui>FAT</gui>. If you only want to use it on Windows, <gui>NTFS</gui> may be a better option.</p>
+ </item>
+ 
+ <item>
+  <p>Give the disk a name and click <gui>Format</gui> to begin wiping the disk.</p>
+ </item>
+ 
+ <item>
+  <p>Once the formatting has finished, <gui>safely remove</gui> the disk. It should now be blank and ready to use again.</p>
+ </item>
+</steps>
+
+<note style="warning">
+ <title>Formatting permanently deletes your files</title>
+ <p>Once the drive has been formatted, the files on it will have been completely removed, so you can't get them back. It is possible that special recovery software could retrieve the files, so formatting a disk is not a completely secure way of wiping a disk.</p>
+</note>
 
 </page>
diff --git a/gnome-help/C/disk-partitions.page b/gnome-help/C/disk-partitions.page
index a873f60..a9cc7dd 100644
--- a/gnome-help/C/disk-partitions.page
+++ b/gnome-help/C/disk-partitions.page
@@ -1,5 +1,5 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic" style="task"
+      type="topic"
       id="disk-partitions">
   <info>
     <link type="guide" xref="hardware#disk"/>
@@ -16,8 +16,10 @@
 
 <title>What are volumes and partitions?</title>
 
-<comment>
- <p>Explain these terms as applied to hard disks (see the palimpsest disk utility)</p>
-</comment>
+<p>A number of technical terms are used to describe ways of dividing-up the available space on hard drives and other storage disks. This topic explains what they mean.</p>
+
+<p>A <em>volume</em></p>
+
+<p>Partitions are sometimes referred to as <em>volumes</em>.</p>
 
 </page>