diff --git a/modules/angular2/src/core/annotations_impl/visibility.ts b/modules/angular2/src/core/annotations_impl/visibility.ts
index c6912414e8..324f27edf1 100644
--- a/modules/angular2/src/core/annotations_impl/visibility.ts
+++ b/modules/angular2/src/core/annotations_impl/visibility.ts
@@ -108,8 +108,9 @@ export class Parent extends Visibility {
  * Specifies that an injector should retrieve a dependency from any ancestor element within the same
  * shadow boundary.
  *
- * An ancestor is any element between the parent element and shadow root.
+ * An ancestor is any element between the parent element and the shadow root.
  *
+ * Use {@link Unbounded} if you need to cross upper shadow boundaries.
  *
  * ## Example
  *
@@ -166,10 +167,10 @@ export class Ancestor extends Visibility {
 }
 
 /**
- * Specifies that an injector should retrieve a dependency from any ancestor element.
- *
- * An ancestor is any element between the parent element and shadow root.
+ * Specifies that an injector should retrieve a dependency from any ancestor element, crossing
+ * component boundaries.
  *
+ * Use {@link Ancestor} to look for ancestors within the current shadow boundary only.
  *
  * ## Example
  *