docs(directives): Add selector notation and some edits for clarity.

Author: naomiblack

lib/directive/ng_class.dart

@@ -82,32 +82,32 @@ class NgClass extends _NgClassBase {
 }
 
 /**
- * Dynamically style only odd rows in a list via data.
+ * Dynamically style only odd rows in an `ng-repeat` list. `Selector: [ng-class-odd]`
  *
- * The `ngClassOdd` and `ngClassEven` directives work exactly as
- * {@link ng.directive:ngClass ngClass}, except it works in
- * conjunction with `ngRepeat` and takes affect only on odd (even) rows.
+ * This directive works exactly as [ngClass] with regard to String, Array,
+ * and Map syntax for associating CSS classes with an element, but only affects odd rows in a
+ * list.
  *
- * This directive can be applied only within a scope of an `ngRepeat`.
+ * Also see [ngClassEven], which applies CSS classes to even rows.
  *
- * ##Examples
- *
- * index.html:
- *
- *     <li ng-repeat="name in ['John', 'Mary', 'Cate', 'Suz']">
- *       <span ng-class-odd="'odd'" ng-class-even="'even'">
- *         {{name}}
- *       </span>
- *     </li>
- *
- * style.css:
+ * ##Example
+ * Let's assume that we have a simple stylesheet that defines two CSS classes for the following
+ * example.
  *
  *     .odd {
  *       color: red;
  *     }
  *     .even {
  *       color: blue;
  *     }
+ *
+ * The following template applies these classes to the odd and even rows respectively:
+ *
+ *     <li ng-repeat="name in ['John', 'Mary', 'Cate', 'Suz']">
+ *       <span ng-class-odd="'odd'" ng-class-even="'even'">
+ *         {{name}}
+ *       </span>
+ *     </li>
  */
 @Decorator(
     selector: '[ng-class-odd]',
@@ -119,30 +119,32 @@ class NgClassOdd extends _NgClassBase {
 }
 
 /**
- * The `ngClassOdd` and `ngClassEven` directives work exactly as
- * {@link ng.directive:ngClass ngClass}, except it works in
- * conjunction with `ngRepeat` and takes affect only on odd (even) rows.
+ * Dynamically style only even rows in an `ng-repeat` list. `Selector: [ng-class-even]`
  *
- * This directive can be applied only within a scope of an `ngRepeat`.
+ * This directive works exactly as [ngClass] with regard to String, Array,
+ * and Map syntax for associating CSS classes with an element, but only affects even rows in a
+ * list.
  *
- * ##Examples
+ * Also see [ngClassEven], which applies CSS classes to even rows.
  *
- * index.html:
- *
- *     <li ng-repeat="name in ['John', 'Mary', 'Cate', 'Suz']">
- *       <span ng-class-odd="'odd'" ng-class-even="'even'">
- *         {{name}}
- *       </span>
- *     </li>
- *
- * style.css:
+ * ##Example
+ * Let's assume that we have a simple stylesheet that defines two CSS classes for the following
+ * example.
  *
  *     .odd {
  *       color: red;
  *     }
  *     .even {
  *       color: blue;
  *     }
+ *
+ * The following template applies these classes to the odd and even rows respectively:
+ *
+ *     <li ng-repeat="name in ['John', 'Mary', 'Cate', 'Suz']">
+ *       <span ng-class-odd="'odd'" ng-class-even="'even'">
+ *         {{name}}
+ *       </span>
+ *     </li>
  */
 @Decorator(
     selector: '[ng-class-even]',

lib/directive/ng_form.dart

@@ -1,9 +1,9 @@
 part of angular.directive;
 
 /**
- * The form directive listens on submission requests and, depending,
- * on if an action is set, the form will automatically either allow
- * or prevent the default browser submission from occurring.
+ * Listens on form submission requests and if an action is set, either allows or
+ * prevents the default browser form submission action from occurring. `Selector: [ng-form]` or
+ * `.ng-form` or `form` or `fieldset`
  */
 @Decorator(
     selector: 'form',

lib/directive/ng_model.dart

@@ -720,7 +720,7 @@ class NgValue {
 
 /**
  * Assigns the value of a bound expression to the model when an input checkbox is
- * checked.
+ * checked. `Selector: input[type=checkbox][ng-model][ng-true-value]`
  *
   * **Usage**
  *
@@ -744,9 +744,9 @@ class NgTrueValue {
 
 /**
  * Assigns the value of a bound expression to the model when an input checkbox is
- * unchecked.
+ * unchecked. `Selector: input[type=checkbox][ng-model][ng-false-value]`
  *
-  * **Usage**
+ * **Usage**
  *
  *     <input type=checkbox
  *            ng-model=model