From 93f63df172fd0eaea7e0df13f6f514b2ae1ecd11 Mon Sep 17 00:00:00 2001
From: Chris Frederick <chris.frederick@github.com>
Date: Mon, 1 Sep 2014 13:10:49 +0900
Subject: [PATCH] Document the :title variable

---
 site/_docs/collections.md | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/site/_docs/collections.md b/site/_docs/collections.md
index b4078c17..94e1ef44 100644
--- a/site/_docs/collections.md
+++ b/site/_docs/collections.md
@@ -81,7 +81,7 @@ For example, if you have `_my_collection/some_subdir/some_doc.md`, it will be wr
         <p><code>collection</code></p>
       </td>
       <td>
-        <p>Label of the containing collection</p>
+        <p>Label of the containing collection.</p>
       </td>
     </tr>
     <tr>
@@ -89,7 +89,7 @@ For example, if you have `_my_collection/some_subdir/some_doc.md`, it will be wr
         <p><code>path</code></p>
       </td>
       <td>
-        <p>Path to the document relative to the collection's directory</p>
+        <p>Path to the document relative to the collection's directory.</p>
       </td>
     </tr>
     <tr>
@@ -97,7 +97,15 @@ For example, if you have `_my_collection/some_subdir/some_doc.md`, it will be wr
         <p><code>name</code></p>
       </td>
       <td>
-        <p>The document's base filename, with every sequence of spaces and non-alphanumeric characters replaced by a hyphen</p>
+        <p>The document's base filename, with every sequence of spaces and non-alphanumeric characters replaced by a hyphen.</p>
+      </td>
+    </tr>
+    <tr>
+      <td>
+        <p><code>title</code></p>
+      </td>
+      <td>
+        <p>The document's lowercase title (as defined in its <a href="/docs/frontmatter/">front matter</a>), with every sequence of spaces and non-alphanumeric characters replaced by a hyphen. If the document does not define a title in its <a href="/docs/frontmatter/">front matter</a>, this is equivalent to <code>name</code>.</p>
       </td>
     </tr>
     <tr>
@@ -105,7 +113,7 @@ For example, if you have `_my_collection/some_subdir/some_doc.md`, it will be wr
         <p><code>output_ext</code></p>
       </td>
       <td>
-        <p>Extension of the output file</p>
+        <p>Extension of the output file.</p>
       </td>
     </tr>
   </tbody>