[seahorse/mallard-help] docs: added group and groups information to learning sections. reworked what-diff-priv-public page

[Jim Campbell <jcampbell src gnome org>]

commit 56738ffb901d5900fb9c5fcf354992d4b240bcb0
Author: Jim Campbell <jwcampbell gmail com>
Date:   Tue Feb 26 01:19:18 2013 +0100

    docs: added group and groups information to learning sections. reworked what-diff-priv-public page

 help/C/encryption-dsa.page           |    2 +-
 help/C/encryption-rsa.page           |    2 +-
 help/C/index.page                    |    2 +-
 help/C/key-strength-define.page      |    2 +-
 help/C/what-diff-private-public.page |   35 ++++++++++++++++-----------------
 5 files changed, 21 insertions(+), 22 deletions(-)
---
diff --git a/help/C/encryption-dsa.page b/help/C/encryption-dsa.page
index 2b22246..653c77d 100644
--- a/help/C/encryption-dsa.page
+++ b/help/C/encryption-dsa.page
@@ -2,7 +2,7 @@
       type="topic" style="task"
       id="encryption-dsa">
   <info>
-    <link type="guide" xref="index#learn-about-keys" group="first"/>
+    <link type="guide" xref="index#learn-about-keys" group="second"/>
     <revision version="0.1" date="2011-10-23" status="draft"/>
 
     <credit type="author">
diff --git a/help/C/encryption-rsa.page b/help/C/encryption-rsa.page
index df5e644..635c992 100644
--- a/help/C/encryption-rsa.page
+++ b/help/C/encryption-rsa.page
@@ -3,7 +3,7 @@
       id="encryption-rsa">
   <info>
     <desc></desc>
-    <link type="guide" xref="index#learn-about-keys" group="first"/>
+    <link type="guide" xref="index#learn-about-keys" group="second"/>
     <revision version="0.1" date="2011-10-23" status="draft"/>
 
     <credit type="author">
diff --git a/help/C/index.page b/help/C/index.page
index 9240ee3..31b209e 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -25,7 +25,7 @@
   to keep your information secure on your computer, and secure when you send
   information over a network.</p>
   
-  <section id="learn-about-keys" style="2column">
+  <section id="learn-about-keys" style="2column" groups="first second third">
     <title>Learn about keys</title>
 
   </section>
diff --git a/help/C/key-strength-define.page b/help/C/key-strength-define.page
index f583a7a..fb7e8a6 100644
--- a/help/C/key-strength-define.page
+++ b/help/C/key-strength-define.page
@@ -2,7 +2,7 @@
       type="topic" style="task"
       id="key-strength-define">
   <info>
-    <link type="guide" xref="index#learn-about-keys"/>
+    <link type="guide" xref="index#learn-about-keys" group="second"/>
     <revision version="0.1" date="2011-10-23" status="stub"/>
 
     <credit type="author">
diff --git a/help/C/what-diff-private-public.page b/help/C/what-diff-private-public.page
index 8d777ef..d63eea5 100644
--- a/help/C/what-diff-private-public.page
+++ b/help/C/what-diff-private-public.page
@@ -3,7 +3,7 @@
       id="what-diff-private-public">
   <info>
     <link type="guide" xref="index#learn-about-keys" group="second"/>
-    <revision version="0.7" date="2012-12-29" status="draft"/>
+    <revision pkgversion="3.8" date="2013-02-26" status="incomplete"/>
 
     <credit type="author">
       <name>Jim Campbell</name>
@@ -17,25 +17,24 @@
   <title>How is a Public key different from a Private key?</title>
 
   <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>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>
+  to as <em>keys</em>, it helps to think of them a bit differently. Try to
+  think of a <em>Public Key</em> as being like a padlock, and a
+  <em>Private Key</em> as being like a key that unlocks the padlock.</p>
+
+  <p>Let's use an example to see how this works. Imagine that you want your
+  friends to send you a secret message in a locked box. You could give each
+  of your friends a box and a padlock, but only you would have the key that
+  unlocks the padlocks.</p>
+
+  <p>Each friend could place their message into their box, and lock the box.
+  They could send you their locked box in the mail, and you could unlock all
+  of the boxes that you receive with your key.</p>
 
   <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>
+  will make it easy for anyone to securely encrypt, or lock, 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 what allows you to
+  decrypt, or unlock, the secure messages that you receive.</p>
 
 </page>