[seahorse] docs: Create key-subkeys.page
- From: Ekaterina Gerasimova <egerasimov src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [seahorse] docs: Create key-subkeys.page
- Date: Mon, 17 Mar 2014 20:03:44 +0000 (UTC)
commit 7457fec9a5df410c55300bf7a3b3690f0d8d7fcf
Author: Aruna Sankaranarayanan <arunasank src gnome org>
Date: Fri Jun 28 15:46:24 2013 +0530
docs: Create key-subkeys.page
Turn page into a landing page.
help/C/key-subkeys.page | 53 ++++++++++++++++++++++++++++++++--------------
1 files changed, 37 insertions(+), 16 deletions(-)
---
diff --git a/help/C/key-subkeys.page b/help/C/key-subkeys.page
index fb74810..e234deb 100644
--- a/help/C/key-subkeys.page
+++ b/help/C/key-subkeys.page
@@ -1,13 +1,16 @@
<page xmlns="http://projectmallard.org/1.0/"
- type="topic" style="task"
+ type="guide" style="task"
id="key-subkeys">
<info>
<link type="guide" xref="learn-about-keys" group="second"/>
+
<revision version="0.1" date="2011-10-23" status="stub"/>
- <credit type="author">
- <name>Jim Campbell</name>
- <email>jwcampbell gmail com</email>
- <years>2011</years>
+ <revision pkgversion="3.9" version="0.1" date="2013-06-28" status="draft"/>
+
+ <credit type="author copyright">
+ <name>Aruna Sankaranarayanan</name>
+ <email>aruna evam gmail com</email>
+ <years>2013</years>
</credit>
<desc></desc>
@@ -15,18 +18,36 @@
<title>What are subkeys?</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>Though it is very important to keep your keys safe, it can become quite
+ tedious to do so when you have many keys. <app>Passwords and Keys</app>
+ provides a simple solution to key safety by using <em>subkeys</em> for
+ signing and encryption.</p>
- <p>Short introductory text...</p>
+ <p>Whenever you create a new public encryption key, a <em>keypair</em> is
+ generated instead of a single key. This keypair consists of a main key, also
+ called the <em>master key</em>, which can only sign, and a <em>subkey</em>
+ for encryption and decryption. Additional subkeys can be created for signing.
+ Each subkey is bound to the master key that created it.</p>
- <steps>
- <item><p>First step...</p></item>
- <item><p>Second step...</p></item>
- <item><p>Third step...</p></item>
- </steps>
+ <list>
+ <title>What does each key in a keypair do?</title>
+ <item>
+ <p>The <em>master key</em> is used for
+ <link xref="key-signing">signing</link> other keys, creating subkeys
+ and <link xref="key-disabling">revoking</link> subkeys. Your master key
+ must be kept very safe. If the master key is compromised, you have no
+ choice but to revoke it and all the subkeys attached to it.</p>
+ </item>
+ <item>
+ <p>The default <em>subkey</em> is used for encryption and decryption
+ of messages. Additional subkeys can be created for signing. Though it
+ is important that your subkeys are kept safe, you can always revoke a
+ subkey if it is compromised and create a new one with the original
+ master key.</p>
+ </item>
+ </list>
+ <section id="more" style="2column">
+ <title>More about subkeys</title>
+ </section>
</page>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]