Adding some more of the changes for the new version.
authorZak Rogoff <zak@fsf.org>
Wed, 13 Aug 2014 20:33:26 +0000 (16:33 -0400)
committerZak Rogoff <zak@fsf.org>
Wed, 13 Aug 2014 20:33:26 +0000 (16:33 -0400)
en/index.html

index 6f9c00c2b001f36a2543d1a82a39670e63049951..d1c6662add354e9a218305765a137be9324c81d8 100644 (file)
                                        </div><!-- /.sidebar -->
                                        <div class="main">
                                                <h3><em>Step 1.a</em> Setup your email program with your email account (if it isn't already)</h3>
-                                               <p>Open your email program and follow the wizard that sets it up with your email account.</p>
+                                               <p>Open your email program and follow the wizard (step-by-step walkthrough) that sets it up with your email account.</p>
 
                                                <!-- ~~~~~~~~~ Troubleshooting  ~~~~~~~~~ -->
                                                <div class="troubleshooting">
                                                        <h4>Troubleshooting</h4>
                                                        <dl>
-                                                               <dt>What's a wizard?</dt>
-                                                                       <dd>A wizard is a series of windows that pop up to make it easy to get something done on a computer, like installing a program. You click through it, selecting options as you go.</dd>
-                                                               <dt>My email program can't find my account or isn't downloading my mail</dt>
+                                                               <dt>The wizard doesn't launch</dt>
+                                                                       <dd>You can launch the wizard yourself, but the menu option for doing so is named differently in each email programs. The button to launch it will be in the program's main menu, under "New" or something similar, titled something like "Add account" or "New/Existing email account."</dd>
+                                                               <dt>The wizard can't find my account or isn't downloading my mail</dt>
                                                                        <dd>Before searching the Web, we recommend you start by asking other people who use your email system, to figure out the correct settings.</dd>
                                                                <dt class="feedback">Don't see a solution to your problem?</dt>
                                                                        <dd class="feedback">Please let us know on the <a href="https://libreplanet.org/wiki/GPG_guide/Public_Review">feedback page</a>.</dd>
                                        </div><!-- /.sidebar -->
                                        <div class="main">
                                                <h3><em>Step 2.a</em> Make a keypair</h3>
-                                               <p>In your email program's menu, select OpenPGP &rarr; Setup Wizard. You don't need to read the text in the window that pops up unless you'd like to, but it's good to read the text on the later screens of the wizard.</p>
+                                               <p>The Enigmail Setup wizard may start automatically. If it doesn't, select OpenPGP &rarr; Setup Wizard from you email program's menu. You don't need to read the text in the window that pops up unless you'd like to, but it's good to read the text on the later screens of the wizard.</p>
                                                <p>On the second screen, titled "Encryption," select "Encrypt all of my messages by default, because privacy is critical to me."</p>
                                                <p>On the third screen, titled "Signing," select "Don't sign my messages by default."</p>
                                                <p>Use the default options until you reach the screen titled "Create Key".</p>
                                                <p>On the screen titled "Create Key," pick a strong password! Your password should be at least 12 characters and include at least one lower case and upper case letter and at least one number or punctuation symbol. Don't forget the password, or all this work will be wasted!</p>
                                        <p class="notes">The program will take a little while to finish the next step, the "Key Creation" screen. While you wait, do something else with your computer, like watching a movie or browsing the Web. The more you use the computer at this point, the faster the key creation will go.</p>
-                                               <p>When the "Key Generation Completed" screen pops up, select Generate Certificate and choose to save it in a safe place on your computer (we recommend making a folder called "Revocation Certificate" in your home folder and keeping it there). You'll learn more about the revocation certificate in <a href="#section5">Section 5</a>. The setup wizard will ask you to move it onto an external device, but that isn't necessary at this moment.</p>
+                                               <p>When the "Key Generation Completed" screen pops up, select Generate Certificate and choose to save it in a safe place on your computer (we recommend making a folder called "Revocation Certificate" in your home folder and keeping it there). You'll learn more about the revocation certificate in <a href="#section5">Section 5</a>.</p>
 
                                                <!-- ~~~~~~~~~ Troubleshooting  ~~~~~~~~~ -->
                                                <div class="troubleshooting">
                                <div id="terminology" class="step">
                                        <div class="main">
                                                <h3>GnuPG, OpenPGP, what?</h3>
-                                               <p>You're using a program called GnuPG, but the menu in your email program is called OpenPGP. Confusing, right? In general, the terms GnuPG, GPG, GNU Privacy Guard, OpenPGP and PGP are used interchangeably, though they all have slightly different meanings.</p>
+                                               <p>In general, the terms GnuPG, GPG, GNU Privacy Guard, OpenPGP and PGP are used interchangeably. Technically, OpenPGP (Pretty Good Privacy) is the encryption standard, and GNU Privacy Guard (often shortened to GPG or GnuPG) is the program that implements the standard.</p>
                                        </div><!-- End .main -->
                                </div><!-- End #terminology.step-->
 
                                                <h3><em>Step 3.a</em> Send Edward your public key</h3>
                                                <p>This is a special step that you won't have to do when corresponding with real people. In your email program's menu, go to OpenPGP &rarr; Key Management. You should see your key in the list that pops up. Right click on your key and select Send Public Keys by Email. This will create a new draft message, as if you had just hit the Write button.</p>
 
-<p>Address the message to edward-en@fsf.org. Put at least one word (whatever you want) in the subject and body of the email, then hit send.</p>
+<p>Address the message to edward-en@fsf.org. Put at least one word (whatever you want) in the subject and body of the email. then hit send.</p>
+
+<p>There should be an icon of a yellow key in the bottom right of the composition window. This means that encryption is on, however, we want this first special message to Edward to be unencrypted. Click the key icon once to turn encryption off. The key should become grey, with a blue dot on it (to alert you that the setting has been changed from the default). Once encryption is off, hit Send.</p>
 
 <p class="notes">It may take two or three minutes for Edward to respond. In the meantime, you might want to skip ahead and check out the <a href="#section5">Use it Well</a> section of this guide. Once he's responded, head to the next step. From here on, you'll be doing just the same thing as when corresponding with a real person.</p>
+
+<p>When you open Edward's reply, Enigmail may prompt you for your password before using your private key to decrypt it.</p>
                                        </div><!-- End .main -->
                                </div><!-- End #step-3a .step -->
 
                                <div id="step-3b" class="step">
                                        <div class="main">
                                                        <h3><em>Step 3.b</em> Send a test encrypted email</h3>
-                                                       <p>Write a new email in your email program, addressed to edward-en@fsf.org. Make the subject "Encryption test" or something similar and write something in the body. Don't send it yet.</p>
-                                                       <p>Click the icon of the key in the bottom right of the composition window (it should turn yellow). This tells Enigmail to encrypt the email.</p>
+                                                       <p>Write a new email in your email program, addressed to edward-en@fsf.org. Make the subject "Encryption test" or something similar and write something in the body.</p>
+                                                       <p>They key in the bottom right of the window should be yellow, meaning encryption is on. This will be your default from now on.</p>
                                                        <p class="notes">Next to the key, you'll notice an icon of a pencil. Clicking this tells Enigmail to add a special, unique signature to your message, generated using your private key. This is a separate feature from encryption, and you don't have to use it for this guide.</p>
                                                        <p>Click Send. Enigmail will pop up a window that says "Recipients not valid, not trusted or not found."</p>
 
                                                        <p>To encrypt an email to Edward, you need his public key, so now you'll have Enigmail download it from a keyserver. Click Download Missing Keys and use the default in the pop-up that asks you to choose a keyserver. Once it finds keys, check the first one (Key ID starting with C), then select ok. Select ok in the next pop-up.</p>
 
-                                                       <p>Now you are back at the "Recipients not valid, not trusted or not found" screen. Select Edward's key from the list and click Ok. If the message doesn't send automatically, you can hit send now.</p>
+                                                       <p>Now you are back at the "Recipients not valid, not trusted or not found" screen. Check the box in front of Edward's key and click Send.</p>
                                        <!-- ~~~~~~~~~ Troubleshooting  ~~~~~~~~~ -->
                                                        <div class="troubleshooting">
                                                                <h4>Troubleshooting</h4>
 
 <p>People's public keys are usually identified by their key fingerprint, which is a string of digits like F357AA1A5B1FA42CFD9FE52A9FF2194CC09A61E8 (for Edward's key). You can see the fingerprint for your public key, and other public keys saved on your computer, by going to OpenPGP &rarr; Key Management in your email program's menu, then right clicking on the key and choosing Key Properties. It's good practice to share your fingerprint wherever you share your email address, so that people can double-check that they have the correct public key when they download yours from a keyserver.</p>
 
-<p class="notes">You may also see public keys referred to by their key ID, which is simply the last 8 digits of the fingerprint, like C09A61E8 for Edward. The key ID is visible directly from the Key Management Window. This key ID is like a person's first name (it is a useful shorthand but may not be unique to a given key), whereas the fingerprint actually identifies the key uniquely without the possibility of confusion. If you only have the key ID, you can still look up the key (as well as its fingerprint), like you did in Step 3, but if multiple options appear, you'll need the fingerprint of the person to whom are trying to communicate to verify which one to use.</p>
+<p class="notes">You may also see public keys referred to by their key ID, which is simply the last 8 digits of the fingerprint, like C09A61E8 for Edward. The key ID is visible directly from the Key Management window. This key ID is like a person's first name (it is a useful shorthand but may not be unique to a given key), whereas the fingerprint actually identifies the key uniquely without the possibility of confusion. If you only have the key ID, you can still look up the key (as well as its fingerprint), like you did in Step 3, but if multiple options appear, you'll need the fingerprint of the person to whom are trying to communicate to verify which one to use.</p>
 
 
                                </div><!-- End .section-intro -->
                                                <p>In your email program's menu, go to OpenPGP &rarr; Key Management.</p>
                                                <p>Right click on Edward's public key and select Sign Key from the context menu.</p>
                                                <p>In the window that pops up, select "I will not answer" and click ok.</p>
-                                               <p>In your email program's menu, go to OpenPGP &rarr; Key Management &rarr; Keyserver &rarr; Upload Public Keys and hit ok.</p>
+                                               <p>Now you should be back at the Key Management menu. Select Keyserver &rarr; Upload Public Keys and hit ok.</p>
                                                <p class="notes">You've just effectively said "I trust that Edward's public key actually belongs to Edward." This doesn't mean much because Edward isn't a real person, but it's good practice.</p>