From d99823e2fd0ef78647de4294d6bb6ab3a40c7145 Mon Sep 17 00:00:00 2001
From: Kara Erickson <karakara@google.com>
Date: Wed, 13 Apr 2016 16:03:30 -0700
Subject: [PATCH] docs(core): fix some grammar

Closes #8055
---
 modules/angular2/src/core/metadata.ts    | 17 +++++++++--------
 modules/angular2/src/core/metadata/di.ts | 15 ++++++++-------
 2 files changed, 17 insertions(+), 15 deletions(-)

diff --git a/modules/angular2/src/core/metadata.ts b/modules/angular2/src/core/metadata.ts
index d02a75d0ff..7637ece7f2 100644
--- a/modules/angular2/src/core/metadata.ts
+++ b/modules/angular2/src/core/metadata.ts
@@ -1106,14 +1106,15 @@ export var ContentChild: ContentChildFactory = makePropDecorator(ContentChildMet
 /**
  * Declares a list of child element references.
  *
- * Angular automatically updates the list when the DOM was updated.
+ * Angular automatically updates the list when the DOM is updated.
  *
  * `ViewChildren` takes a argument to select elements.
  *
  * - If the argument is a type, directives or components with the type will be bound.
  *
- * - If the argument is a string, the string behaviors as comma-separated selectors. For each
- * selector, an element matched template variables (e.g. `#child`) will be bound.
+ * - If the argument is a string, the string is interpreted as a list of comma-separated selectors.
+ * For each selector, an element containing the matching template variable (e.g. `#child`) will be
+ * bound.
  *
  * View children are set before the `ngAfterViewInit` callback is called.
  *
@@ -1185,17 +1186,17 @@ export var ViewChildren: ViewChildrenFactory = makePropDecorator(ViewChildrenMet
 
 // TODO(alexeagle): remove the duplication of this doc. It is copied from ViewChildMetadata.
 /**
- * Declares a reference of child element.
+ * Declares a reference to a child element.
  *
  * `ViewChildren` takes a argument to select elements.
  *
  * - If the argument is a type, a directive or a component with the type will be bound.
  *
- * - If the argument is a string, the string behaviors as a selectors. An element matched template
- * variables (e.g. `#child`) will be bound.
+ * - If the argument is a string, the string is interpreted as a selector. An element containing the
+ * matching template variable (e.g. `#child`) will be bound.
  *
- * In either case, `@ViewChild()` assigns the first (looking from above) element if the result is
- * multiple.
+ * In either case, `@ViewChild()` assigns the first (looking from above) element if there are
+ * multiple matches.
  *
  * View child is set before the `ngAfterViewInit` callback is called.
  *
diff --git a/modules/angular2/src/core/metadata/di.ts b/modules/angular2/src/core/metadata/di.ts
index e3b6e49423..69c34a0b1a 100644
--- a/modules/angular2/src/core/metadata/di.ts
+++ b/modules/angular2/src/core/metadata/di.ts
@@ -287,14 +287,15 @@ export class ViewQueryMetadata extends QueryMetadata {
 /**
  * Declares a list of child element references.
  *
- * Angular automatically updates the list when the DOM was updated.
+ * Angular automatically updates the list when the DOM is updated.
  *
  * `ViewChildren` takes an argument to select elements.
  *
  * - If the argument is a type, directives or components with the type will be bound.
  *
- * - If the argument is a string, the string behaviors as comma-separated selectors. For each
- * selector, an element matched template variables (e.g. `#child`) will be bound.
+ * - If the argument is a string, the string is interpreted as a list of comma-separated selectors.
+ * For each selector, an element containing the matching template variable (e.g. `#child`) will be
+ * bound.
  *
  * View children are set before the `ngAfterViewInit` callback is called.
  *
@@ -373,11 +374,11 @@ export class ViewChildrenMetadata extends ViewQueryMetadata {
  *
  * - If the argument is a type, a directive or a component with the type will be bound.
  *
- * - If the argument is a string, the string behaviors as a selectors. An element matched template
- * variables (e.g. `#child`) will be bound.
+ If the argument is a string, the string is interpreted as a selector. An element containing the
+ matching template variable (e.g. `#child`) will be bound.
  *
- * In either case, `@ViewChild()` assigns the first (looking from above) element if the result is
- * multiple.
+ * In either case, `@ViewChild()` assigns the first (looking from above) element if there are
+ multiple matches.
  *
  * View child is set before the `ngAfterViewInit` callback is called.
  *