From b4b74f7e1dd52e043500ad7dbd40bef68f6676b2 Mon Sep 17 00:00:00 2001
From: Silvio Giebl <silvio.giebl@hivemq.com>
Date: Thu, 9 Jul 2020 23:43:33 +0200
Subject: [PATCH] Added documentation for doc_collections

---
 docs/configuration.md | 41 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/docs/configuration.md b/docs/configuration.md
index 65471d2..3e7a1f8 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -22,6 +22,47 @@ Just the Docs has some specific configuration parameters that can be defined in
 
 View this site's [_config.yml](https://github.com/pmarsceill/just-the-docs/tree/master/_config.yml) file as an example.
 
+## Document collections
+
+By default, the navigation display normal [pages](https://jekyllrb.com/docs/pages/).
+Instead, you can also use [Jekyll collections](https://jekyllrb.com/docs/collections/).
+Collections group documents that semantically belong together.
+
+For example, to group all documentation, put all your files in the `_docs` folder and create the `docs` collection:
+```yaml
+# Define Jekyll collections
+collections:
+  # Define a collection named "docs", its documents reside in the "_docs" directory
+  docs:
+    permalink: "/:collection/:path/"
+    output: true
+
+# Define which collections are used in just-the-docs
+doc_collections:
+  # Reference the "docs" collection
+  docs:
+    # Give the collection a name
+    name: Documentation
+```
+
+You can reference multiple collections.
+This creates categories in the navigation with the configured names.
+```yaml
+collections:
+  docs:
+    permalink: "/:collection/:path/"
+    output: true
+  tutorials:
+    permalink: "/:collection/:path/"
+    output: true
+
+doc_collections:
+  docs:
+    name: Documentation
+  tutorials:
+    name: Tutorials
+```
+
 ## Site logo
 
 ```yaml