diff --git a/packages/core/src/metadata/directives.ts b/packages/core/src/metadata/directives.ts
index 4c5a08f544..0784cef48b 100644
--- a/packages/core/src/metadata/directives.ts
+++ b/packages/core/src/metadata/directives.ts
@@ -342,9 +342,12 @@ export interface Directive {
    * View queries are set before the `ngAfterViewInit` callback is called.
    *
    * @usageNotes
+   *
    * ### Example
    *
-   * The followoing example (shows what??)
+   * The following example shows how queries are defined
+   * and when their results are available in lifecycle hooks:
+   *
    * ```
    * @Component({
    *   selector: 'someDir',
@@ -475,7 +478,7 @@ export interface Directive {
 }
 
 /**
- * Type of the Component metadata.
+ * Type of the Directive metadata.
  */
 export const Directive: DirectiveDecorator = makeDecorator(
     'Directive', (dir: Directive = {}) => dir, undefined, undefined,