From a1d45f97177afcceeb69ca9c8530eadb30049948 Mon Sep 17 00:00:00 2001
From: ashmaroli <ashmaroli@users.noreply.github.com>
Date: Fri, 27 Oct 2017 21:25:07 +0530
Subject: [PATCH] Add a note on `:jekyll_plugins` group in the docs (#6488)

Merge pull request 6488
---
 docs/_docs/plugins.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/docs/_docs/plugins.md b/docs/_docs/plugins.md
index 7d218b4e..ab3ca5ad 100644
--- a/docs/_docs/plugins.md
+++ b/docs/_docs/plugins.md
@@ -68,6 +68,24 @@ You have 3 options for installing plugins:
   </p>
 </div>
 
+### The jekyll_plugins group
+
+Jekyll gives this particular group of gems in your `Gemfile` a different
+treatment. Any gem included in this group is loaded before Jekyll starts
+processing the rest of your source directory.
+
+A gem included here will be activated even if its not explicitly listed under
+the `plugins:` key in your site's config file.
+
+<div class="note warning">
+  <p>
+    Gems included in the <code>:jekyll-plugins</code> group are activated
+    regardless of the <code>--safe</code> mode setting. Be careful of what
+    gems are included under this group!
+  </p>
+</div>
+
+
 In general, plugins you make will fall broadly into one of five categories:
 
 1. [Generators](#generators)