JavaScript-Resource
diff --git a/‎modules/angular2/src/core/linker/element_ref.ts‎
Lines changed: 4 additions & 3 deletions b/‎modules/angular2/src/core/linker/element_ref.ts‎
Lines changed: 4 additions & 3 deletions
diff --git a/‎modules/angular2/src/core/metadata/view.ts‎
Lines changed: 7 additions & 3 deletions b/‎modules/angular2/src/core/metadata/view.ts‎
Lines changed: 7 additions & 3 deletions
@@ -54,15 +54,16 @@ export class ElementRef implements RenderElementRef {
    * <div class="callout is-critical">
    *   <header>Use with caution</header>
    *   <p>
-   *    Use this api as the last resort when direct access to DOM is needed. Use templating and
-   *    data-binding provided by Angular instead.
+   *    Use this API as the last resort when direct access to DOM is needed. Use templating and
+   *    data-binding provided by Angular instead. Alternatively you take a look at {@link Renderer}
+   *    which provides API that can safely be used even when direct access to native elements is not
+   *    supported.
    *   </p>
    *   <p>
    *    Relying on direct DOM access creates tight coupling between your application and rendering
    *    layers which will make it impossible to separate the two and deploy your application into a
    *    web worker.
    *   </p>
-   *   <!-- TODO: add info about custom renderers that should be used instead -->
    * </div>
    */
   get nativeElement(): any { return this._renderer.getNativeElementSync(this); }
 
@@ -4,7 +4,7 @@ import {ViewEncapsulation} from 'angular2/src/core/render/api';
 export {ViewEncapsulation} from 'angular2/src/core/render/api';
 
 /**
- * Declares the available HTML templates for an application.
+ * Metadata properties available for configuring Views.
  *
  * Each Angular component requires a single `@Component` and at least one `@View` annotation. The
  * `@View` annotation specifies the HTML template to use, and lists the directives that are active
@@ -39,19 +39,23 @@ export class ViewMetadata {
   /**
    * Specifies a template URL for an Angular component.
    *
-   * NOTE: either `templateUrl` or `template` should be used, but not both.
+   * NOTE: Only one of `templateUrl` or `template` can be defined per View.
+   *
+   * <!-- TODO: what's the url relative to? -->
    */
   templateUrl: string;
 
   /**
    * Specifies an inline template for an Angular component.
    *
-   * NOTE: either `templateUrl` or `template` should be used, but not both.
+   * NOTE: Only one of `templateUrl` or `template` can be defined per View.
    */
   template: string;
 
   /**
    * Specifies stylesheet URLs for an Angular component.
+   *
+   * <!-- TODO: what's the url relative to? -->
    */
   styleUrls: string[];