diff --git a/modules/@angular/core/src/metadata.ts b/modules/@angular/core/src/metadata.ts
index d6568b650f..bda0ec4da9 100644
--- a/modules/@angular/core/src/metadata.ts
+++ b/modules/@angular/core/src/metadata.ts
@@ -1089,12 +1089,21 @@ export var ContentChildren: ContentChildrenMetadataFactory =
  * })
  * class SomeDir {
  *   @ContentChild(ChildDirective) contentChild;
+ *   @ContentChild('container_ref') containerChild
  *
  *   ngAfterContentInit() {
  *     // contentChild is set
+ *     // containerChild is set
  *   }
  * }
  * ```
+ * 
+ * ```html
+ * <container #container_ref>
+ *   <item>a</item>
+ *   <item>b</item>
+ * </container>
+ * ```
  */
 export var ContentChild: ContentChildMetadataFactory = makePropDecorator(ContentChildMetadata);