diff --git a/lib/src/common/directives/ng_class.dart b/lib/src/common/directives/ng_class.dart
index 86674f9bf..f7da479a6 100644
--- a/lib/src/common/directives/ng_class.dart
+++ b/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
diff --git a/lib/src/common/directives/ng_for.dart b/lib/src/common/directives/ng_for.dart
index c0b94dcf7..c40d63b16 100644
--- a/lib/src/common/directives/ng_for.dart
+++ b/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(
diff --git a/lib/src/common/directives/ng_if.dart b/lib/src/common/directives/ng_if.dart
index cc8330724..01555d98f 100644
--- a/lib/src/common/directives/ng_if.dart
+++ b/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
 ///
diff --git a/lib/src/common/directives/ng_style.dart b/lib/src/common/directives/ng_style.dart
index 4658b5fed..aa31a3ae4 100644
--- a/lib/src/common/directives/ng_style.dart
+++ b/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
 ///
diff --git a/lib/src/common/directives/ng_switch.dart b/lib/src/common/directives/ng_switch.dart
index 0d3a3c2be..7689eced8 100644
--- a/lib/src/common/directives/ng_switch.dart
+++ b/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
diff --git a/lib/src/common/forms/directives/ng_model.dart b/lib/src/common/forms/directives/ng_model.dart
index 76dbd3c94..d149a4e60 100644
--- a/lib/src/common/forms/directives/ng_model.dart
+++ b/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
diff --git a/lib/src/core/di/provider.dart b/lib/src/core/di/provider.dart
index 4bbbf73f1..a785291af 100644
--- a/lib/src/core/di/provider.dart
+++ b/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
 ///