diff --git a/docs/FAQ.md b/docs/FAQ.md
index 1d222e1a1d..7788284739 100644
--- a/docs/FAQ.md
+++ b/docs/FAQ.md
@@ -182,7 +182,7 @@ You can [modify a tool's build configuration](How-to-Build-Software-Outside-Home
Chances are that certain apps will give you a popup message like this:
-
+
This is a [security feature from Apple](https://support.apple.com/en-us/HT202491). The single most important thing to know is that **you can allow individual apps to be exempt from this feature.** This allows the app to run while the rest of the system remains under protection.
@@ -190,11 +190,11 @@ This is a [security feature from Apple](https://support.apple.com/en-us/HT202491
If you're sure you want to trust the app, you can disable protection for it by right-clicking its icon and choosing *Open*:
-
+
In the resulting dialog, click the *Open* button to have macOS permanently allow the app to run on this Mac. **Don’t do this unless you’re sure you trust the app.**
-
+
Alternatively, you may provide the [`--no-quarantine` flag](https://github.com/Homebrew/homebrew-cask/blob/HEAD/USAGE.md#options) at install time to not add this feature to a specific app.
@@ -204,7 +204,7 @@ After running `brew upgrade`, you may notice some casks you think should be upgr
As you’re likely aware, a lot of macOS software can upgrade itself:
-
+
That could cause conflicts when used in tandem with Homebrew Cask’s `upgrade` mechanism.
diff --git a/docs/assets/img/docs/gatekeeper-unidentified-message.png b/docs/assets/img/docs/gatekeeper-unidentified-message.png
new file mode 100644
index 0000000000..94833c329c
Binary files /dev/null and b/docs/assets/img/docs/gatekeeper-unidentified-message.png differ
diff --git a/docs/assets/img/docs/gatekeeper-unidentified-open.png b/docs/assets/img/docs/gatekeeper-unidentified-open.png
new file mode 100644
index 0000000000..2c0e0f7eae
Binary files /dev/null and b/docs/assets/img/docs/gatekeeper-unidentified-open.png differ
diff --git a/docs/assets/img/docs/right-click-choose-open.png b/docs/assets/img/docs/right-click-choose-open.png
new file mode 100644
index 0000000000..c42f6a79cc
Binary files /dev/null and b/docs/assets/img/docs/right-click-choose-open.png differ
diff --git a/docs/assets/img/docs/sparkle-test-app-software-update.png b/docs/assets/img/docs/sparkle-test-app-software-update.png
new file mode 100644
index 0000000000..76f0fe9958
Binary files /dev/null and b/docs/assets/img/docs/sparkle-test-app-software-update.png differ