[seahorse/mallard-help: 13/14] docs: added draft to explain public vs private keys.

[David King <davidk src gnome org>]

commit b0857fa370e7003072446b4c585fa7c8f7547d06
Author: Jim Campbell <jwcampbell gmail com>
Date:   Sat Dec 29 16:13:25 2012 -0600

    docs: added draft to explain public vs private keys.

 help/C/what-diff-private-public.page |   40 +++++++++++++++++++++------------
 1 files changed, 25 insertions(+), 15 deletions(-)
---
diff --git a/help/C/what-diff-private-public.page b/help/C/what-diff-private-public.page
index 65ee164..4803308 100644
--- a/help/C/what-diff-private-public.page
+++ b/help/C/what-diff-private-public.page
@@ -3,31 +3,41 @@
       id="what-diff-private-public">
   <info>
     <link type="guide" xref="index#learn-about-keys"/>
-    <revision version="0.1" date="2011-10-23" status="stub"/>
+    <revision version="0.7" date="2012-12-29" status="draft"/>
 
     <credit type="author">
       <name>Jim Campbell</name>
       <email>jwcampbell gmail com</email>
-      <years>2011</years>
     </credit>
+    
+    <!-- TODO Insert pictures to that illustrate these concepts -->
 
-    <desc></desc>
+    <desc>Public keys are like padlocks, and Private keys unlock the padlocks
+    </desc>
   </info>
 
-  <title>What is the difference between a private and a public key?</title>
+  <title>How is a Public key different from a Private key?</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>Although <em>Public Keys</em> and <em>Private Keys</em> are both referred
+  to as keys, you can actually think of a <em>Public Key</em> as being like a
+  padlock, and you can think of a <em>Private Key</em> as being like a key that
+  unlocks the padlock.</p>
 
-  <p>Short introductory text...</p>
+  <p>As an example, imagine that you want your friends to send you a secret
+  message in a locked box. Using our analogy, you would first give each of your
+  friends a box and a duplicate copy of a padlock. However, only you would have
+  the key that unlocks those padlocks. You would keep that key private - you
+  wouldn't share it with anyone.</p>
+  
+  <p>Your friends could then place their secret messages into their boxes, and
+  lock the boxes with the padlocks. They would then send you the locked boxes
+  via messenger, and you could open the boxes with your key.</p>
 
-  <steps>
-    <item><p>First step...</p></item>
-    <item><p>Second step...</p></item>
-    <item><p>Third step...</p></item>
-  </steps>
+  <p>This is similar to how a <em>Public Key</em> and a <em>Private Key</em>
+  work. Like the padlock, you can freely give out your <em>Public Key</em>. This
+  will make it easy for anyone to securely encode a message that they want to
+  send to you. Similarly, you will want to keep your <em>Private Key</em> safe.
+  The <em>Private Key</em> is the tool that you will use to decode the secure
+  messages that you receive.</p>
 
 </page>