From cd49baeaab632803b63e64001a0ce27352bdb601 Mon Sep 17 00:00:00 2001
From: Cedric Beust <cedric@beust.com>
Date: Wed, 18 Nov 2015 00:01:56 -0800
Subject: [PATCH] Syntax doc.

---
 documentation/index.html | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/documentation/index.html b/documentation/index.html
index ae265a7..c3d9a25 100644
--- a/documentation/index.html
+++ b/documentation/index.html
@@ -129,6 +129,34 @@ Here are a few noteworthy details about this small build file:
 <li>The functions <code>kotlinProject</code> and <code>homeDir</code> are supplied by Kobalt and are referred to as "directives"
 </ul>
 
+          <p>
+              In terms of syntax, there are basically three different ways to specify values in a build file:
+          </p>
+          <ul>
+              <li>Individual values for primitives (numbers, strings) are a straight equals sign:
+                  <pre>
+name = "kobalt"</pre>
+              </li>
+
+              <li>
+                  Parameters that can receive multiple values are usually captured by function calls, so you use parentheses, as usual in Kotlin:
+                  <pre>
+compile("dep1", "dep2", "dep2")</pre>
+              </li>
+
+              <li>
+                  Complex objects are passed as closures, so you use curly braces to define them:
+                  <pre>
+dependencies {
+    ...
+}</pre>
+              </li>
+          </ul>
+          <p>
+              Remember that a build file is a valid Kotlin source, so you can use function calls instead of literal values, or any other correct Kotlin code in your build file:
+          </p>
+          <pre>
+version = readVersion()</pre>
 <h3 class="section" indent="1" id="directives">Directives</h3>
 
 <p>