next round of comments
authorzoe1 <zoe@fsf.org>
Thu, 8 Jul 2021 21:14:00 +0000 (23:14 +0200)
committerzoe1 <zoe@fsf.org>
Thu, 8 Jul 2021 21:14:00 +0000 (23:14 +0200)
en/index.html

index 531171a797de378c789cb56455c9bf95b98de221..ab69d3c3308ca7377e900429de8abb542f0e1b2a 100644 (file)
@@ -617,8 +617,8 @@ page</a>.</dd>
 
 <h3><em>Step 1.b</em> Get your terminal ready and install GnuPG</h3>
 
-<p>If you are working on a GNU/Linux machine, you should already have GnuPG installed, and you can skip to <a href="#section2">Step 2</a>.</p>
-<p>If you are working on a macOS or Windows machine however, you need to first install the GnuPG program. Select your operating system below and follow the steps. For the rest of the steps in this guide, the steps are the same for all operating systems. </p>
+<p>If you are using a GNU/Linux machine, you should already have GnuPG installed, and you can skip to <a href="#section2">Step 2</a>.</p>
+<p>If you are using a macOS or Windows machine, however, you need to first install the GnuPG program. Select your operating system below and follow the steps. For the rest of the steps in this guide, the steps are the same for all operating systems. </p>
 
 <!-- ~~~~~~~~~ MACOS ~~~~~~~~~ -->
 <div class="troubleshooting">
@@ -627,7 +627,7 @@ page</a>.</dd>
 
 <dl>
 <dt>Use a third-party package manager to install GnuPG</dt>
-<dd>Your macOS comes with a pre-installed terminal which we'll use to setup your encryption using the GnuPG program. However, the default macOS package manager makes it difficult to install GnuPG and other pieces of free software.</p>
+<dd>Your macOS comes with a terminal pre-installed, which we'll use to setup your encryption with GnuPG. However, the default macOS package manager makes it difficult to install GnuPG and other pieces of free software (like Emacs, GIMP, or Inkscape).</p>
 To make things easier, we recommend setting up the third-party package manager "Homebrew" to install GnuPG. Copy the link on the home page of <a href="https://brew.sh/">Homebrew</a> and paste it in your Terminal. Click "Enter" and wait for it to finalize.</p>
 When it is done, install the program by entering the following code:</p>
 <text style="color:#2f5faa; font-family: monospace;">brew install gnupg gnupg2</text>. After installation is done, you can follow the steps of the rest of this guide.</dd>
@@ -645,7 +645,7 @@ When it is done, install the program by entering the following code:</p>
 <dd><a href="https://www.gpg4win.org/">GPG4Win</a> is a email and file encryption software package that includes GnuPG. Download and install the latest version, choosing default options whenever asked. After it's installed, you can close any windows that it creates.</p>
 Open the "Powershell" and follow the steps of the rest of this guide.
 
-<p class="notes">When we refer to the "terminal" in the rest of this guide, for your Windows machine, that is the "Powershell"</p>
+<p class="notes">We use the word "terminal" in the rest of this guide, but on your Windows machine, that program will be called "PowerShell."</p>
 </dd>
 </dl>
 
@@ -754,8 +754,8 @@ song lyrics, quotes from books, and so on.</p>
 <dl>
 <dt>GnuPG is not installed</dt>
 <dd>
-GPG is not installed. You can check if this is the case with the command <text style="color:#2f5faa; font-family: monospace;">gnupg --version</text>
-If Gnupg is not installed, it would bring up the following result:
+GPG is not installed. You can check if this is the case with the command <text style="color:#2f5faa; font-family: monospace;">gpg --version</text>
+If GnuPG is not installed, it would bring up the following result on most GNU/Linux operating systems, or something like it:
 <text style="color:#2f5faa; font-family: monospace;">Command 'gpg' not found, but can be installed with:
   sudo apt install gnupg</text>. Follow that command and install the program.</dd>
 
@@ -764,15 +764,15 @@ If Gnupg is not installed, it would bring up the following result:
 
 <dt>How can i see my key?</dt>
 <dd>
-Use the following command to see all keys <text style="color:#2f5faa; font-family: monospace;">gnupg --list-keys</text>. Yours should be listed in there, and later, so will Edward's (<a href="#section3">section 3</a>). If you want to see only your key, you can use <text style="color:#2f5faa; font-family: monospace;">gnupg --list-key [your@email]</text>
-You can also use <text style="color:#2f5faa; font-family: monospace;">gnupg --list-secret-key</text> to see your own private key.</dd>
+Use the following command to see all keys <text style="color:#2f5faa; font-family: monospace;">gpg --list-keys</text>. Yours should be listed in there, and later, so will Edward's (<a href="#section3">section 3</a>). If you want to see only your key, you can use <text style="color:#2f5faa; font-family: monospace;">gpg --list-key [your@email]</text>
+You can also use <text style="color:#2f5faa; font-family: monospace;">gpg --list-secret-key</text> to see your own private key.</dd>
 
 <dt>More resources</dt>
 <dd>For more information about this process, you can also refer to <a
 href="https://www.gnupg.org/gph/en/manual/c14.html#AEN25">The GNU Privacy
 Handbook</a>. Make sure you stick with "RSA and RSA" (the default),
 because it's newer and more secure than the algorithms the documentation
-recommends. Also make sure your key is at least 4096 if you
+recommends. Also make sure your key is at least 4096 bits if you
 want to be secure.</dd>
 
 <dt class="feedback">Don't see a solution to your problem?</dt>
@@ -876,7 +876,7 @@ page</a>.</dd>
 <dl>
 <dt>More about keyservers</dt>
 <dd>You can find some more keyserver information<a
-href="https://www.gnupg.org/gph/en/manual/x457.html">in this manual</a>. <a
+href="https://www.gnupg.org/gph/en/manual/x457.html"> in this manual</a>. <a
 href="https://sks-keyservers.net/overview-of-pools.php">The sks Web site</a>
 maintains a list of highly interconnected keyservers. You can also <a
 href="https://www.gnupg.org/gph/en/manual/x56.html#AEN64">directly export
@@ -1226,7 +1226,7 @@ then it will use your private key to decrypt it.</p>
 </div><!-- End #step-4e .step -->
 </div></section>
 
-<!-- ~~~~~~~~~ Section 5: Learn the Web of Trust ~~~~~~~~~ -->
+<!-- ~~~~~~~~~ Section 5: Learn About the Web of Trust ~~~~~~~~~ -->
 <section class="row" id="section5"><div>
 
 <!-- ~~~~~~~~~ section introduction: interspersed text ~~~~~~~~~ -->