[seahorse/wip/userdocs: 1/71] Docs: Modify pgp-publish.page

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit bd1133b928014ccd06c7a95eed1d283004d262fc
Author: Aruna Sankaranarayanan <arunasank src gnome org>
Date:   Wed Aug 28 23:12:08 2013 +0530

    Docs: Modify pgp-publish.page
    
    Add note about key servers in pgp-publish.page and delete the
    about-key-servers.page.
    
    Reword note about key servers, by adding information about eky servers
    using the internet.
    Add a note about needing the internet to publish keys.
    Mark page for review.

 help/C/pgp-publish.page |   46 +++++++++++++++++++++++++++++++++++-----------
 1 files changed, 35 insertions(+), 11 deletions(-)
---
diff --git a/help/C/pgp-publish.page b/help/C/pgp-publish.page
index 7737435..c770554 100644
--- a/help/C/pgp-publish.page
+++ b/help/C/pgp-publish.page
@@ -7,7 +7,7 @@
     <link type="guide" xref="pgp"/>
 
     <revision version="0.1" date="2011-10-23" status="stub"/>
-    <revision pkgversion="3.9" version="0.1" date="2013-06-18" status="draft"/>
+    <revision pkgversion="3.9" date="2013-06-18" status="review"/>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
@@ -17,36 +17,49 @@
       <years>2013</years>
     </credit>
 
-    <desc>Make your keys downloadable from key servers.</desc>
+    <desc>Publish your public keys on key servers, or
+    <link xref="misc-key-export">export</link> and mail them to your
+    friends.</desc>
   </info>
 
-  <title>Publish your public keys</title>
+  <title>Share your public keys</title>
 
   <p>If you want people to send you encrypted communication, you must share
   your <gui>GnuPG keys</gui> with them. To share your key with a selected few
-  people, <link xref="misc-key-export">export</link> the desired key and mail
+  people, <link xref="misc-key-export">export</link> it and mail
   the resulting keyfile to them. To allow anyone to
   <link xref="pgp-retrieve-remote">retrieve</link> and use your public key,
   publish it on a key server.</p>
 
   <steps>
-    <title>How do I publish my key?</title>
+    <title>How do I publish my key on a key server?</title>
     <item>
-      <p>Select the PGP key you want to publish.</p>
+      <p>Select <gui>GnuPG keys</gui> from the left side panel.</p>
+    </item>
+    <item>
+      <p>From the list, select the <gui>Personal PGP key</gui> you want to
+      publish.</p>
     </item>
     <item>
       <p>Select <guiseq><gui style="menu">Remote</gui>
       <gui style="menuitem">Sync and Publish Keys…</gui></guiseq>.</p>
     </item>
     <item>
-      <p>Click the <gui style="button">Key Servers</gui> button to see the list
+      <p>Press the <gui style="button">Key Servers</gui> button to see the list
       of key servers on which you can publish your public key.</p>
     </item>
     <item>
-      <p>From the <gui style="group">Publish keys to</gui> menu, select the key
-      server that you want to publish your key on.</p>
+      <p>To publish your key on a key server of your choice, select the key
+      server from the <gui>Publish keys to</gui> menu.</p>
+    </item>
+    <item>
+      <p>Press <gui style="button">Close</gui> to go back to the previous
+      dialog.</p>
     </item>
     <item>
+      <p>Press <gui style="button">Sync</gui> to finish.</p>
+    </item>
+   <!-- <item>
       <p>Tick the
       <gui style="checkbox">Automatically retrieve keys from key servers</gui>
       checkbox to retrieve any key that is published on the server you have
@@ -54,8 +67,19 @@
       <gui style="checkbox">Automatically sync modified keys with key servers</gui>
       checkbox to ensure that any modifications to a key on the key server,
       like a signature, are updated on your copy of the key too.</p>
-      <!--Not sure about this - Aruna 18/08/2013-->
-    </item>
+      Not sure about this - Aruna 18/08/2013
+    </item>-->
   </steps>
 
+  <note style="important">
+    <p>You need to be connected to the Internet while publishing your keys.</p>
+  </note>
+
+  <note style="info">
+    <title>What is a keyserver?</title>
+    <p>Key servers are computers that store copies of public encryption keys
+    submitted to them, and share these copies with other key servers through
+    the Internet.</p>
+  </note>
+
 </page>