aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorsaturneric <[email protected]>2026-08-10 23:50:39 +0200
committersaturneric <[email protected]>2026-08-10 23:50:39 +0200
commitc24bf3fd657621365a8f751d7429dafa21e6c125 (patch)
treea92e8e3f0eda2401bb7d92fc38c203eb98e81d47
parentdocs(advanced): clarify wording across advanced docs (diff)
downloadmanual-c24bf3fd657621365a8f751d7429dafa21e6c125.tar.gz
manual-c24bf3fd657621365a8f751d7429dafa21e6c125.zip
docs(overview): clarify downloads and FAQ wording
- change "flavours" to "versions" and simplify installed/portable text - explain installed keeps settings and keys in the user folder - clarify portable keeps everything in the program folder for USB use - state the two versions do not share data and switching resets state - update getting-started note to match downloads wording - rephrase search hint to "Type what you are looking for" for clarity - clarify DSA/RSA < 2048 are no longer offered for new keys per RFC 9580 - recommend verifying downloads before installation with improved wording
-rw-r--r--src/content/docs/overview/downloads.mdx12
-rw-r--r--src/content/docs/overview/faq.mdx15
-rw-r--r--src/content/docs/overview/getting-started.mdx6
3 files changed, 17 insertions, 16 deletions
diff --git a/src/content/docs/overview/downloads.mdx b/src/content/docs/overview/downloads.mdx
index d2c270c..3f33a59 100644
--- a/src/content/docs/overview/downloads.mdx
+++ b/src/content/docs/overview/downloads.mdx
@@ -30,16 +30,16 @@ Other options, for special cases only:
### Installed or Portable?
-Most downloads come in two flavours, and you need to pick one:
+Most downloads come in two versions, and you need to pick one:
-- **Installed**: the normal choice. Your settings and keys go in your user
- folder, where they belong.
+- **Installed**: the normal choice. Your settings and keys are stored in your
+ user folder.
- **Portable**: everything stays in the program's own folder, so you can run it
from a USB drive and leave nothing behind.
-The two do not share anything. Switching from one to the other looks like
-starting from scratch, so pick the one you want up front. See
-[Portable Mode](/advanced/portable-mode/).
+The two versions do not share any data. If you switch from one to the other,
+you start with empty settings and no keys. So pick the one you want before
+you start. See [Portable Mode](/advanced/portable-mode/).
For macOS there is only an installed version.
diff --git a/src/content/docs/overview/faq.mdx b/src/content/docs/overview/faq.mdx
index b544281..b9a4d59 100644
--- a/src/content/docs/overview/faq.mdx
+++ b/src/content/docs/overview/faq.mdx
@@ -365,8 +365,8 @@ guide](/appendix/translate-interface) on GitHub!
The settings window was rebuilt in v2.2.2. The row of tabs across the top is
gone, replaced by a search box and a list of pages down the left side.
-Type what you are after into the search box. It matches page names and the
-settings on them, so you do not have to guess. See [Finding Your
+Type what you are looking for into the search box. It matches page names and
+the settings on them, so you do not have to guess. See [Finding Your
Settings](/guides/settings/).
</details>
@@ -422,10 +422,11 @@ those keys back in it. See [Key Categories](/guides/key-categories/).
<details>
<summary>Why can I no longer generate a DSA key?</summary>
-On the rPGP engine, DSA and RSA keys below 2048 bits are no longer offered for
-new keys, because RFC 9580 no longer considers them good enough.
+On the rPGP engine, DSA and RSA keys below 2048 bits are no longer offered
+for new keys. The current OpenPGP standard (RFC 9580) says they are no longer
+safe enough.
-Existing keys of those kinds still import and still work. The GnuPG engine
+Existing keys of these types still import and still work. The GnuPG engine
still offers both if you really need one.
</details>
@@ -436,8 +437,8 @@ still offers both if you really need one.
It was removed in v2.2.2. GpgFrontend no longer verifies its own libraries
while starting.
-Checking that your download is genuine is still worth doing, and is better done
-before you install. See [Code & Binary
+It is still a good idea to check that your download is genuine. The best time
+to do that is before you install. See [Code & Binary
Verify](/appendix/code-binary-verify/).
</details>
diff --git a/src/content/docs/overview/getting-started.mdx b/src/content/docs/overview/getting-started.mdx
index 7239afe..dcbfb7d 100644
--- a/src/content/docs/overview/getting-started.mdx
+++ b/src/content/docs/overview/getting-started.mdx
@@ -107,9 +107,9 @@ If you are new to PGP, we strongly recommend reading our [Fundamental Concepts](
:::note[Installed or portable?]
-Most downloads come in two flavours. The **installed** one keeps your settings
-and keys in your user folder, and is what you want unless you have a reason to
-choose otherwise. The **portable** one keeps everything next to the program, so
+Most downloads come in two versions. The **installed** one keeps your
+settings and keys in your user folder. Choose it unless you have a special
+reason not to. The **portable** one keeps everything next to the program, so
you can run it from a USB drive.
They do not share data, so pick one before you start setting things up. See