[seahorse/wip/userdocs: 37/433] Updated help: key-strength-define.page

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit 890e04477a34b7a17fab1b5f03f5c5328b5427f1
Author: Aruna Sankaranarayanan <arunasank src gnome org>
Date:   Fri Jun 21 08:03:24 2013 +0530

    Updated help: key-strength-define.page
    
    Explained what key strength is.
    Have looked at the website mentioned in Stef's comment,
    but should figure out how to phrase it properly in this page.

 help/C/key-strength-define.page |   41 +++++++++++++++++++++++---------------
 1 files changed, 25 insertions(+), 16 deletions(-)
---
diff --git a/help/C/key-strength-define.page b/help/C/key-strength-define.page
index db9a291..df940d5 100644
--- a/help/C/key-strength-define.page
+++ b/help/C/key-strength-define.page
@@ -3,12 +3,13 @@
       id="key-strength-define">
   <info>
     <link type="guide" xref="learn-about-keys" group="second"/>
+
     <revision version="0.1" date="2011-10-23" status="stub"/>
+    <revision pkgversion="3.9" version="0.1" date="2013-06-21" status="draft"/>
 
-    <credit type="author">
-      <name>Jim Campbell</name>
-      <email>jwcampbell gmail com</email>
-      <years>2011</years>
+    <credit type="author copyright">
+      <name>Aruna Sankaranarayanan</name>
+      <email>aruna evam gmail com</email>
     </credit>
 
     <desc></desc>
@@ -16,11 +17,26 @@
 
   <title>What does key strength mean?</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>Whenever you pick a password, there are two factors to consider: the
+  length of the password and how uncommon the password is. You try to satisfy
+  these requirements by choosing a reasonably long password with a random mix
+  of lower case and upper case alphabets, special characters, and numbers. This
+  makes the generated password less easy to guess, and thus, more secure.</p>
+
+  <p>The idea of key strength is similar. <app>Passwords and Keys</app>
+  generates an uncommon and different number every single time you create a
+  key, which you can think of as a secret password made by the key to keep
+  your encrypted data safe. However, it is left to you to choose your key
+  strength, which is the size of the generated random number. Key strength can
+  be defined in terms of 1024, 1536 or 2048 bits.</p>
+
+  <p>It is quite easy to see that higher the key strength, the more difficult
+  and time consuming it is to guess the associated random number. You should
+  choose your key strength in <app>Passwords and Keys</app> depending on how
+  long you intend to use the key, that is, depending on how long you want the
+  key to remain secure. Keys having a higher value of key strength remain
+  secure for more number of years. In fact it would take an average computer
+  more than 14 billion years to crack a key that is 2048 bits long.</p>
 
   <!-- stefw: I would suggest basing this page off the current
     reccomendations for key strength. The basic concepts for key
@@ -33,12 +49,5 @@
     Note that in general in seahorse we ar etalking about the Assymetric key strength
     not the Symmetric ones.
   -->
-  <p>Short introductory text...</p>
-
-  <steps>
-    <item><p>First step...</p></item>
-    <item><p>Second step...</p></item>
-    <item><p>Third step...</p></item>
-  </steps>
 
 </page>