[seahorse/wip/userdocs: 287/416] help: Changes to ssh pages



commit 60ae1cdbdc18f7c2f49de743b4399fe2e588253d
Author: Jim Campbell <jwcampbell gmail com>
Date:   Mon Aug 12 12:31:30 2013 -0500

    help: Changes to ssh pages
    
    rm ssh-login page. started create-ssh-key.page. edited pub-private and connect-other-comp.

 help/C/connect-other-computer.page   |   10 +++++-
 help/C/create-ssh-key.page           |   49 +++++++++++++++++++++++----------
 help/C/ssh-login.page                |   39 ---------------------------
 help/C/what-diff-private-public.page |   12 ++++----
 4 files changed, 48 insertions(+), 62 deletions(-)
---
diff --git a/help/C/connect-other-computer.page b/help/C/connect-other-computer.page
index 8c0f979..c76d021 100644
--- a/help/C/connect-other-computer.page
+++ b/help/C/connect-other-computer.page
@@ -14,13 +14,19 @@
       <email its:translate="no">jwcampbell gmail com</email>
     </credit>
 
-    <desc>Use SSH keys to connect to another computer without entering a
+    <credit> type="author">
+      <name>Aruna Sankaranarayanan</name>
+      <email its:translate="no">aruna evam gmail com</email>
+    </credit>
+
+    <desc>Use SSH keys to log in to another computer without entering a
     password.</desc>
   </info>
 
   <title>Connect to other computers</title>
 
-  <p>Short introductory text...</p>
+  <p>You can use <app>Passwords and Keys</app> to install your SSH key onto a
+remote computer. If the other computer is configured p</p>
 
   <steps>
     <item><p>First step...</p></item>
diff --git a/help/C/create-ssh-key.page b/help/C/create-ssh-key.page
index 19f97ad..5d06b84 100644
--- a/help/C/create-ssh-key.page
+++ b/help/C/create-ssh-key.page
@@ -1,18 +1,19 @@
 <page xmlns="http://projectmallard.org/1.0/";
       xmlns:its="http://www.w3.org/2005/11/its";
+      xmlns:ui = "http://projectmallard.org/ui/1.0/";
       type="topic" style="task"
       id="create-ssh-key">
   <info>
     <link type="guide" xref="index#ssh-keys"/>
 
-    <revision version="0.1" date="2011-06-17" status="stub"/>
+    <revision version="0.8" date="2013-08-12" status="incomplete"/>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
     <credit type="author">
       <name>Jim Campbell</name>
       <email its:translate="no">jwcampbell gmail com</email>
-      <years>2011</years>
+      <years>2013</years>
     </credit>
 
     <desc>Create SSH keys to login to other computers.</desc>
@@ -20,18 +21,36 @@
 
   <title>Create a new SSH key</title>
 
-  <comment>
-    <cite date="2011-06-17" 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>Short introductory text...</p>
-
-  <steps>
-    <item><p>First step...</p></item>
-    <item><p>Second step...</p></item>
-    <item><p>Third step...</p></item>
-  </steps>
+  <p>An SSH key will help you to create a secure connection between computers.
+  Creating an SSH key creates both a <em>Public</em> and a <em>Private</em>
+  key. Here is how to create a new key:</p>
+  
+    <steps>
+      <item><p>Click <guiseq><gui>File</gui><gui>New</gui></guiseq>.</p></item>
+      <item><p>Select <gui>Secure Shell Key</gui> and then click
+      <gui>Continue</gui>.</p></item>
+      <item><p>Enter a description for the key. The key description will help
+      you to identify the key later. For example, you could enter today's date,
+      something about how the key will be used, or the server name on which you
+      intend to install the key. The description field is optional, and how you
+      describe the key is entirely up to you.</p></item>
+      <item><p>You can change default settings for encryption type or key
+      strength by expanding the Advanced key options panel.</p></item>
+    </steps>
+    
+  <p>At this point, you can either just create your key, or create your key
+  and set it up on a remote server.</p>
+  
+  <section id="ssh-just-create-key" ui:expanded="true">
+    <title>Just create your key</title>
+    <p>Instructions for just creating keys.</p>
+    
+  </section>
+
+  <section id="ssh-create-key-and-set-up" ui:expanded="false">
+    <title>Create your key and install it on a remote computer</title>
+    <p>Instructions to create it and set it up.</p>
+    
+  </section>
 
 </page>
diff --git a/help/C/what-diff-private-public.page b/help/C/what-diff-private-public.page
index bebd88e..82d3983 100644
--- a/help/C/what-diff-private-public.page
+++ b/help/C/what-diff-private-public.page
@@ -27,18 +27,18 @@
   <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
+  friends to use a locked box to send you a secret message. 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>
+  They could send you their locked box in the mail, and you could use your key
+  to unlock all of the boxes that you receive.</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 encrypt, or lock, a message that
-  they want to send to you. Similarly, you will want to keep your
+  work. Like the padlock, you can freely give out your <em>Public Key</em>.
+  This 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>
 


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]