From bc9895aa9b76dc1e6a3157f03e0440bfda08391e Mon Sep 17 00:00:00 2001
From: Shannon Kularathna <30392854+shannonxtreme@users.noreply.github.com>
Date: Thu, 27 Aug 2020 12:50:17 -0400
Subject: [PATCH] Clarify description of `safe` option (#8354)

Merge pull request 8354
---
 docs/_docs/configuration/options.md | 2 +-
 docs/_docs/plugins.md               | 3 +++
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/_docs/configuration/options.md b/docs/_docs/configuration/options.md
index 0e8c69ad..ea142979 100644
--- a/docs/_docs/configuration/options.md
+++ b/docs/_docs/configuration/options.md
@@ -44,7 +44,7 @@ class="flag">flags</code> (specified on the command-line) that control them.
       <td>
         <p class="name"><strong>Safe</strong></p>
         <p class="description">
-          Disable <a href="/docs/plugins/">custom plugins</a>, caching to disk
+          Disable <a href="/docs/plugins/">non-whitelisted plugins</a>, caching to disk,
           and ignore symbolic links.
         </p>
       </td>
diff --git a/docs/_docs/plugins.md b/docs/_docs/plugins.md
index 79a30d3c..52a86941 100644
--- a/docs/_docs/plugins.md
+++ b/docs/_docs/plugins.md
@@ -7,6 +7,9 @@ Jekyll has a plugin system with hooks that allow you to create custom generated
 content specific to your site. You can run custom code for your site without
 having to modify the Jekyll source itself.
 
+{: .note .info}
+You can add specific plugins to the `whitelist` key in `_config.yml` to allow them to run in safe mode.
+
 * [Installation]({{ '/docs/plugins/installation/' | relative_url }}) - How to install plugins
 * [Your first plugin]({{ '/docs/plugins/your-first-plugin/' | relative_url }}) - How to write plugins
 * [Generators]({{ '/docs/plugins/generators/' | relative_url }}) - Create additional content on your site