A few more changes

Author: nep

docs/control-panel/settings/captcha.md

@@ -11,7 +11,7 @@
 
 **Control Panel Location: `Settings > CAPTCHA`**
 
-This section of the Control Panel allows you to set [CAPTCHA](security/captchas.md) preferences for your website.
+This section of the Control Panel allows you to set the [CAPTCHA](security/captchas.md) preferences for your website.
 
 ## Settings
 
@@ -23,6 +23,16 @@ If members are logged in, they will not have to enter a CAPTCHA unless the [Requ
 
 Superadmins are not required to submit a captcha and are never shown one.
 
+### Require CAPTCHA while logged in?
+
+If you enable this preference, then even members who are logged in will need to fill out CAPTCHA information in order to post, for example, comments (assuming you've enabled CAPTCHA support for comment posting). If you disable this setting, then members who are logged in will bypass the CAPTCHA check.
+
+### Use reCAPTCHA v3?
+
+If you enable this preference then the system will use reCAPTCHA v3 in place of the built-in image based solution. You will also want to ensure that you [update any code](security/captchas.md#captcha-code) used to output CAPTCHAs on your site.
+
+## Built-in CAPTCHA Settings
+
 ### Use TrueType font?
 
 If your server supports TrueType Fonts, then you can enable this setting. If you receive errors such as Call to undefined function: imagettftext() on your site then your server does not support TrueType Fonts and you should set this to "No".
@@ -31,10 +41,6 @@ If your server supports TrueType Fonts, then you can enable this setting. If you
 
 Specify whether to add a random three-digit number to the end of each generated CAPTCHA word. This makes it more difficult for scripts to guess or brute-force the form submission.
 
-### Require CAPTCHA while logged in?
-
-If you enable this preference, then members who are logged in will need to fill out CAPTCHA information in order to post comments (assuming you've enabled CAPTCHA support for comment posting). If you disable this setting, then members who are logged in can bypass the CAPTCHA check.
-
 ### CAPTCHA directory
 
 The URL to your [CAPTCHA](security/captchas.md) images. In most cases, this will be similar to:
@@ -55,11 +61,9 @@ If you do not know what to use for your full server path, contact your Host or s
 
 ## reCAPTCHA v3 Settings
 
-If you wish to use Google reCAPTCH v3 as a replacement you will need to ensure that the site is set up with Google to gain the required site key and secret. See https://www.google.com/recaptcha/admin/create
-
-### Use reCAPTCHA v3?
+If you wish to use (Google reCAPTCHA v3)[https://cloud.google.com/security/products/recaptcha#how-it-works] as a replacement for the built-in functionality, you will need to ensure that the site is set up with Google with the required site key and secret.
 
-If you enable this preference then the system will use reCAPTCHA v3 in place of the older image-based CAPTCHA method built into ExpressionEngine.
+Note that there is currently a monthly limit on the number of free CAPTCHAs that Google provides. See https://www.google.com/recaptcha/admin/create
 
 ### reCAPTCHA site key
 

docs/troubleshooting/templates.md

@@ -64,16 +64,17 @@ Ensure that the channel field is being called within the template. For example,
 
 ## CAPTCHA images not appearing
 
-CAPTCHAs are enabling but there is a blank space where they should appear.
+CAPTCHAs are enabled but there is a blank space where they should appear.
 
 ### Troubleshooting missing CAPTCHA Images
 
 There are several possible reasons for CAPTCHA images to not appear:
 
-- The path and/or URL to the CAPTCHA directory is not specified correctly under `Settings --> CAPTCHA`.
+- The path and/or URL to the CAPTCHA directory is not specified correctly under [`Settings --> CAPTCHA`](control-panel/settings/captcha.md).
 - The `images/captchas/` directory is not writable. See [File Permissions](troubleshooting/general.md#file-permissions) for details.
 - The server does not support True Type Fonts. TrueType Fonts can be disabled in `Settings --> CAPTCHA`.
 - GD library isn't installed and/or working correctly
+- You are logged in as a superadmin, and superadmins are not required to solve CAPTCHAs
 
 ## Can not save a template with the {exp:query} tag