From 1d726a87b9a376678a9393d163f438745b0bc69e Mon Sep 17 00:00:00 2001
From: Frederic Hemberger <mail@frederic-hemberger.de>
Date: Sat, 18 Oct 2014 08:29:26 +0200
Subject: [PATCH] Docs: Clarify behavior of 'categories' in permalinks

---
 site/_docs/permalinks.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/site/_docs/permalinks.md b/site/_docs/permalinks.md
index 0c01721e..dbcee2e2 100644
--- a/site/_docs/permalinks.md
+++ b/site/_docs/permalinks.md
@@ -89,9 +89,10 @@ permalink is defined as `/:categories/:year/:month/:day/:title.html`.
       </td>
       <td>
         <p>
-          The specified categories for this Post. Jekyll automatically parses
-          out double slashes in the URLs, so if no categories are present, it
-          will ignore this.
+          The specified categories for this Post. If a post has multiple
+          categories, Jekyll will create a hierarchy (e.g. <code>/category1/category2</code>).
+          Also Jekyll automatically parses out double slashes in the URLs,
+          so if no categories are present, it will ignore this.
         </p>
       </td>
     </tr>