diff --git a/src/ng/directive/ngClass.js b/src/ng/directive/ngClass.js
index 595b4419adc5..154553473946 100644
--- a/src/ng/directive/ngClass.js
+++ b/src/ng/directive/ngClass.js
@@ -71,6 +71,20 @@ function classDirective(name, selector) {
  * The `ngClass` directive allows you to dynamically set CSS classes on an HTML element by databinding
  * an expression that represents all classes to be added.
  *
+ * The directive operates in three different ways, depending on which of three types the expression
+ * evaluates to:
+ * 
+ * 1. If the expression evaluates to a string, the string should be one or more space-delimited class
+ * names.
+ * 
+ * 2. If the expression evaluates to an array, each element of the array should be a string that is
+ * one or more space-delimited class names.
+ * 
+ * 3. If the expression evaluates to a map object (hash table), then for each key-value pair of the
+ * object, if the value is truthy, then the key, as a string, is included as a class name.
+ * Note that no extra quoting of the keys or values is necessary in this case.  See the example.
+ * 
+ * 
  * The directive won't add duplicate classes if a particular class was already set.
  *
  * When the expression changes, the previously added classes are removed and only then the