[seahorse/wip/userdocs: 332/433] Review password-keyring-create help page

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit 721857b9774489c79697752d65898e8822612b2a
Author: Ekaterina Gerasimova <kittykat3756 gmail com>
Date:   Wed Aug 21 21:28:59 2013 +0100

    Review password-keyring-create help page
    
    Add a seealso to updating passwords to replace the note from the bottom
    of the page. Remove document version number from the revision tag (the
    document version corresponds to the package version that it is written
    for). Shorten title. Use more active language. Try to make the
    instructions more consise (fail at one point, add a TODO to fix later).

 help/C/passwords-keyring-create.page |   56 ++++++++++++++-------------------
 1 files changed, 24 insertions(+), 32 deletions(-)
---
diff --git a/help/C/passwords-keyring-create.page b/help/C/passwords-keyring-create.page
index 53d9a29..daf78b0 100644
--- a/help/C/passwords-keyring-create.page
+++ b/help/C/passwords-keyring-create.page
@@ -5,9 +5,10 @@
 
   <info>
     <link type="guide" xref="passwords"/>
+    <link type="seealso" xref="passwords-keyring-update-password" />
 
     <revision version="0.1" date="2011-10-23" status="draft"/>
-    <revision pkgversion="3.9" version="0.1" date="2013-07-03" status="review"/>
+    <revision pkgversion="3.10" date="2013-08-21" status="review"/>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
@@ -16,59 +17,50 @@
       <email its:translate="no">aruna evam gmail com</email>
       <years>2013</years>
     </credit>
+    <credit type="editor">
+      <name>Ekaterina Gerasimova</name>
+      <email its:translate="no">kittykat3756 gmail com</email>
+      <years>2013</years>
+    </credit>
 
     <desc>Use password keyrings to group stored passwords.</desc>
   </info>
 
-  <title>Create a new password keyring</title>
+  <title>Create a new keyring</title>
 
-  <p>Password keyrings can be used to group related or similar passwords. You
-  can choose to protect your keyring with a password.</p>
+  <p>Use <link xref="about-keyring">keyrings</link> to group related passwords.
+  You can choose to protect your keyring with a password.</p>
 
   <steps>
-    <title>To create a new password keyring:</title>
+    <title>Create a new password keyring:</title>
     <item>
       <p>Select <guiseq><gui style="menu">File</gui>
       <gui style="menuitem">New…</gui></guiseq>.</p>
     </item>
     <item>
-      <p>From the list of options, select <gui>Password Keyring</gui> and press
+      <p>Choose <gui>Password Keyring</gui> and press
       <gui style="button">Continue</gui>.</p>
     </item>
     <item>
-      <p>In the <gui>Add Password Keyring</gui> dialog type in a new name for
-      your password keyring in the <gui>New Keyring Name</gui> field and
-      press <gui style="button">Add</gui>.</p>
+      <p>Chose a name for your new keyring, then press
+      <gui style="button">OK</gui> to continue.</p>
     </item>
     <item>
-      <p>If you want your keyring to be protected with a password, type a
-      password of your choice in the <gui>Password</gui> field. Otherwise,
-      leave this field blank.</p>
+      <!-- TODO: make shorter -->
+      <p>If you want your keyring to be protected with a password, chose one
+      now. If you do not with to use a password, leave these fields blank. This
+      is the password which you will need to use to unlock the keyring.</p>
     </item>
     <item>
-      <p>To confirm your password, retype it in the <gui>Confirm</gui> field.
-      This field can be left blank if the <gui>Password</gui> field has been
-      left blank.</p>
+      <p>Press <gui style="button">Continue</gui> to finish creating the
+      keyring. If you have not protected your keyring with a password, you will
+      need to confirm that this is how you want to proceed.</p>
     </item>
     <item>
-      <p>Press the <gui style="button">Continue</gui> button. If you have not
-      protected your keyring with a password, <app>Passwords and Keys</app>
-      will ask you to confirm your decision to do so. Press the
-      <gui>Continue</gui> button in the new dialog, to confirm your decision
-      and finish.</p>
-    </item>
-    <item>
-      <p>Your new password keyring will now be listed under
-      <gui>Passwords</gui> if <guiseq><gui style="menu">View</gui>
-      <gui style="menuitem">By keyring</gui></guiseq> has been ticked.
-      Otherwise it will be sorted alphabetically.</p>
+      <p>Your new keyring will now be listed under <gui>Passwords</gui> if you
+      have the keyring pane enabled.<!--TODO: link to view page, if it
+      exists --></p>
     </item>
   </steps>
 
-  <note style="tip">
-    <p>The password to protect a keyring can be
-    <link xref="passwords-keyring-update-password">updated</link> at any
-    time.</p>
-  </note>
-
 </page>