API docs: copyedits in followup to #124

lib/src/common/directives/ng_class.dart

@@ -46,7 +46,7 @@ import 'package:angular2/src/core/change_detection/differs/default_keyvalue_diff
 /// ```
 ///
 /// Try the [live example][ex].
-/// See the [Template Syntax section on `ngClass`][guide] for more details.
+/// For details, see the [`ngClass` discussion in the Template Syntax][guide] page.
 ///
 /// [ex]: examples/template-syntax/#ngClass
 /// [guide]: docs/guide/template-syntax.html#ngClass

lib/src/common/directives/ng_for.dart

@@ -83,7 +83,7 @@ import "../../core/change_detection/differs/default_iterable_differ.dart"
 /// </template>
 /// ```
 ///
-/// See the [Template Syntax section on `ngFor`][guide] for details.
+/// For details, see the [`ngFor` discussion in the Template Syntax][guide] page.
 ///
 /// [guide]: docs/guide/template-syntax.html#ngFor
 @Directive(

lib/src/common/directives/ng_if.dart

@@ -1,11 +1,10 @@
 import 'package:angular2/core.dart'
     show Directive, ViewContainerRef, TemplateRef;
 
-/// Causes an element and its contents to be added/removed from the DOM
-/// conditionally, based on the value of the supplied boolean template
-/// expression.
+/// Causes an element and its contents to be conditionally added/removed from
+/// the DOM based on the value of the given boolean template expression.
 ///
-/// See the [Template Syntax section on `ngIf`][guide] for more details.
+/// For details, see the [`ngIf` discussion in the Template Syntax][guide] page.
 ///
 /// ### Examples
 ///

lib/src/common/directives/ng_style.dart

@@ -14,7 +14,7 @@ import '../../core/change_detection/differs/default_keyvalue_differ.dart'
 /// are set based on the map entries: each _key_:_value_ pair identifies a
 /// style property _name_ and its _value_.
 ///
-/// See the [Template Syntax section on `NgStyle`][guide] for more details.
+/// For details, see the [`ngStyle` discussion in the Template Syntax][guide] page.
 ///
 /// ### Examples
 ///

lib/src/common/directives/ng_switch.dart

@@ -60,7 +60,7 @@ class SwitchView {
 /// ```
 ///
 /// Try the [live example][ex].
-/// See the [Template Syntax section on `ngSwitch`][guide] for more details.
+/// For details, see the [`ngSwitch` discussion in the Template Syntax][guide] page.
 ///
 /// [ex]: examples/template-syntax/#ngSwitch
 /// [guide]: docs/guide/template-syntax.html#ngSwitch

lib/src/common/forms/directives/ng_model.dart

@@ -36,7 +36,7 @@ const formControlBinding = const Provider(NgControl, useExisting: NgModel);
 /// need is the `ngModel` selector to activate it. For a two-way binding, use
 /// the `[(ngModel)]` syntax to ensure the model updates in both directions.
 ///
-/// Learn more about `ngModel` in the Guide [Forms](docs/guide/forms.html#ngModel)
+/// Learn more about `ngModel` in the [Forms](docs/guide/forms.html#ngModel)
 /// and [Template Syntax](docs/guide/template-syntax.html#ngModel) pages.
 ///
 /// ### Examples

lib/src/core/di/provider.dart

@@ -158,16 +158,15 @@ class Provider {
   bool get multi => _multi ?? false;
 }
 
-/// Creates an injector [Provider] for the given [token] based on a given
+/// Creates a [Provider] that associates [token] with one of the following:
 ///
-/// - Class
-/// - Value
-/// - Factory function, or
+/// - A class
+/// - A value
+/// - A factory function
 /// - Another token
 ///
-/// The [token] is most commonly a class or an opaque token. More details
-/// concerning providers can be found in the [Dependency Injection][di] page
-/// of the Angular Guide.
+/// A [token] is most commonly a class. See the [Dependency Injection][di] page
+/// for more details.
 ///
 /// ### Example
 ///