[seahorse/wip/userdocs: 12/218] docs: Create key-subkeys.page

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit a005d40765a803d625885ba191b7c980b4789d41
Author: Aruna Sankaranarayanan <arunasank src gnome org>
Date:   Fri Jun 28 15:46:24 2013 +0530

    docs: Create key-subkeys.page
    
    Turn page into a landing page.

 help/C/key-subkeys.page |   53 ++++++++++++++++++++++++++++++++--------------
 1 files changed, 37 insertions(+), 16 deletions(-)
---
diff --git a/help/C/key-subkeys.page b/help/C/key-subkeys.page
index fb74810..e234deb 100644
--- a/help/C/key-subkeys.page
+++ b/help/C/key-subkeys.page
@@ -1,13 +1,16 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic" style="task"
+      type="guide" style="task"
       id="key-subkeys">
   <info>
     <link type="guide" xref="learn-about-keys" group="second"/>
+
     <revision version="0.1" date="2011-10-23" status="stub"/>
-    <credit type="author">
-      <name>Jim Campbell</name>
-      <email>jwcampbell gmail com</email>
-      <years>2011</years>
+    <revision pkgversion="3.9" version="0.1" date="2013-06-28" status="draft"/>
+
+    <credit type="author copyright">
+      <name>Aruna Sankaranarayanan</name>
+      <email>aruna evam gmail com</email>
+      <years>2013</years>
     </credit>
 
     <desc></desc>
@@ -15,18 +18,36 @@
 
   <title>What are subkeys?</title>
 
-  <comment>
-    <cite date="2011-10-23" href="mailto:jwcampbell gmail com">Jim Campbell</cite>
-    <p>This assumes the reader knows how to.... By the end of this page,
-    the reader will be able to....</p>
-  </comment>
+  <p>Though it is very important to keep your keys safe, it can become quite
+  tedious to do so when you have many keys. <app>Passwords and Keys</app>
+  provides a simple solution to key safety by using <em>subkeys</em> for
+  signing and encryption.</p>
 
-  <p>Short introductory text...</p>
+  <p>Whenever you create a new public encryption key, a <em>keypair</em> is
+  generated instead of a single key. This keypair consists of a main key, also
+  called the <em>master key</em>, which can only sign, and a <em>subkey</em>
+  for encryption and decryption. Additional subkeys can be created for signing.
+  Each subkey is bound to the master key that created it.</p>
 
-  <steps>
-    <item><p>First step...</p></item>
-    <item><p>Second step...</p></item>
-    <item><p>Third step...</p></item>
-  </steps>
+  <list>
+    <title>What does each key in a keypair do?</title>
+      <item>
+       <p>The <em>master key</em> is used for
+       <link xref="key-signing">signing</link> other keys, creating subkeys
+       and <link xref="key-disabling">revoking</link> subkeys. Your master key
+       must be kept very safe.  If the master key is compromised, you have no
+       choice but to revoke it and all the subkeys attached to it.</p>
+      </item>
+      <item>
+       <p>The default <em>subkey</em> is used for encryption and decryption
+       of messages. Additional subkeys can be created for signing. Though it
+       is important that your subkeys are kept safe, you can always revoke a
+       subkey if it is compromised and create a new one with the original
+       master key.</p>
+      </item>
+  </list>
 
+  <section id="more" style="2column">
+    <title>More about subkeys</title>
+  </section>
 </page>