diff --git a/modules/@angular/common/src/common_module.ts b/modules/@angular/common/src/common_module.ts
index 0d1d66ced2..92c5e51725 100644
--- a/modules/@angular/common/src/common_module.ts
+++ b/modules/@angular/common/src/common_module.ts
@@ -15,7 +15,7 @@ import {COMMON_PIPES} from './pipes/common_pipes';
 // Note: This does not contain the location providers,
 // as they need some platform specific implementations to work.
 /**
- * The module that includes all the basic Angular directives like {@link NgIf}, ${link NgFor}, ...
+ * The module that includes all the basic Angular directives like {@link NgIf}, {@link NgFor}, ...
  *
  * @stable
  */
diff --git a/modules/@angular/common/src/location/location.ts b/modules/@angular/common/src/location/location.ts
index b7fbc1cfe1..8ff9dc494c 100644
--- a/modules/@angular/common/src/location/location.ts
+++ b/modules/@angular/common/src/location/location.ts
@@ -79,7 +79,7 @@ export class Location {
 
   /**
    * Given a string representing a URL, returns the normalized URL path without leading or
-   * trailing slashes
+   * trailing slashes.
    */
   normalize(url: string): string {
     return Location.stripTrailingSlash(_stripBaseHref(this._baseHref, _stripIndexHtml(url)));
diff --git a/modules/@angular/common/src/location/location_strategy.ts b/modules/@angular/common/src/location/location_strategy.ts
index 97ba81885c..b76120d98d 100644
--- a/modules/@angular/common/src/location/location_strategy.ts
+++ b/modules/@angular/common/src/location/location_strategy.ts
@@ -49,6 +49,7 @@ export abstract class LocationStrategy {
  *
  * ### Example
  *
+ * ```typescript
  * import {Component, NgModule} from '@angular/core';
  * import {APP_BASE_HREF} from '@angular/common';
  *
diff --git a/modules/@angular/common/src/pipes/date_pipe.ts b/modules/@angular/common/src/pipes/date_pipe.ts
index f2f9ffe41f..248931ae5c 100644
--- a/modules/@angular/common/src/pipes/date_pipe.ts
+++ b/modules/@angular/common/src/pipes/date_pipe.ts
@@ -57,13 +57,13 @@ import {InvalidPipeArgumentError} from './invalid_pipe_argument_error';
  *  - `'medium'`: equivalent to `'yMMMdjms'` (e.g. Sep 3, 2010, 12:05:08 PM for en-US)
  *  - `'short'`: equivalent to `'yMdjm'` (e.g. 9/3/2010, 12:05 PM for en-US)
  *  - `'fullDate'`: equivalent to `'yMMMMEEEEd'` (e.g. Friday, September 3, 2010 for en-US)
- *  - `'longDate'`: equivalent to `'yMMMMd'` (e.g. September 3, 2010)
+ *  - `'longDate'`: equivalent to `'yMMMMd'` (e.g. September 3, 2010 for en-US)
  *  - `'mediumDate'`: equivalent to `'yMMMd'` (e.g. Sep 3, 2010 for en-US)
  *  - `'shortDate'`: equivalent to `'yMd'` (e.g. 9/3/2010 for en-US)
  *  - `'mediumTime'`: equivalent to `'jms'` (e.g. 12:05:08 PM for en-US)
  *  - `'shortTime'`: equivalent to `'jm'` (e.g. 12:05 PM for en-US)
  *
- * Timezone of the formatted text will be the local system timezone of the end-users machine.
+ * Timezone of the formatted text will be the local system timezone of the end-user's machine.
  *
  * ### Examples
  *
diff --git a/modules/@angular/common/src/pipes/i18n_plural_pipe.ts b/modules/@angular/common/src/pipes/i18n_plural_pipe.ts
index 5f1d99443c..3e51328285 100644
--- a/modules/@angular/common/src/pipes/i18n_plural_pipe.ts
+++ b/modules/@angular/common/src/pipes/i18n_plural_pipe.ts
@@ -18,7 +18,7 @@ const _INTERPOLATION_REGEXP: RegExp = /#/g;
  *
  *  ## Usage
  *
- *  expression | i18nPlural:mapping
+ *      expression | i18nPlural:mapping
  *
  *  where `expression` is a number and `mapping` is an object that mimics the ICU format,
  *  see http://userguide.icu-project.org/formatparse/messages
diff --git a/modules/@angular/common/src/pipes/number_pipe.ts b/modules/@angular/common/src/pipes/number_pipe.ts
index 7027198ac4..90ec1edeb2 100644
--- a/modules/@angular/common/src/pipes/number_pipe.ts
+++ b/modules/@angular/common/src/pipes/number_pipe.ts
@@ -60,7 +60,7 @@ function formatNumber(
 
 /**
  * WARNING: this pipe uses the Internationalization API.
- * Therefore it is only reliable in Chrome and Opera browsers. For other browsers please use an
+ * Therefore it is only reliable in Chrome and Opera browsers. For other browsers please use a
  * polyfill, for example: [https://github.com/andyearnshaw/Intl.js/].
  *
  * Formats a number as local text. i.e. group sizing and separator and other locale-specific
@@ -98,7 +98,7 @@ export class DecimalPipe implements PipeTransform {
 
 /**
  * WARNING: this pipe uses the Internationalization API.
- * Therefore it is only reliable in Chrome and Opera browsers. For other browsers please use an
+ * Therefore it is only reliable in Chrome and Opera browsers. For other browsers please use a
  * polyfill, for example: [https://github.com/andyearnshaw/Intl.js/].
  *
  * Formats a number as local percent.
@@ -126,7 +126,7 @@ export class PercentPipe implements PipeTransform {
 
 /**
  * WARNING: this pipe uses the Internationalization API.
- * Therefore it is only reliable in Chrome and Opera browsers. For other browsers please use an
+ * Therefore it is only reliable in Chrome and Opera browsers. For other browsers please use a
  * polyfill, for example: [https://github.com/andyearnshaw/Intl.js/].
  *
  *
@@ -140,7 +140,7 @@ export class PercentPipe implements PipeTransform {
  * "EUR" for the euro. `symbolDisplay` is a boolean indicating whether to use the currency
  * symbol (e.g. $) or the currency code (e.g. USD) in the output. The default for this value
  * is `false`.
- * For more information about `digitInfo` see {@link DecimalPipe}
+ * For more information about `digitInfo` see {@link DecimalPipe}.
  *
  * ### Example
  *
diff --git a/modules/@angular/core/src/linker/compiler.ts b/modules/@angular/core/src/linker/compiler.ts
index b1f3e9cf23..ba3618047f 100644
--- a/modules/@angular/core/src/linker/compiler.ts
+++ b/modules/@angular/core/src/linker/compiler.ts
@@ -68,14 +68,14 @@ export class Compiler {
   compileModuleAsync<T>(moduleType: Type<T>): Promise<NgModuleFactory<T>> { throw _throwError(); }
 
   /**
-   * Same as {@link compileModuleSync} put also creates ComponentFactories for all components.
+   * Same as {@link compileModuleSync} but also creates ComponentFactories for all components.
    */
   compileModuleAndAllComponentsSync<T>(moduleType: Type<T>): ModuleWithComponentFactories<T> {
     throw _throwError();
   }
 
   /**
-   * Same as {@link compileModuleAsync} put also creates ComponentFactories for all components.
+   * Same as {@link compileModuleAsync} but also creates ComponentFactories for all components.
    */
   compileModuleAndAllComponentsAsync<T>(moduleType: Type<T>):
       Promise<ModuleWithComponentFactories<T>> {
@@ -83,7 +83,7 @@ export class Compiler {
   }
 
   /**
-   * Clears all caches
+   * Clears all caches.
    */
   clearCache(): void {}
 
diff --git a/modules/@angular/core/src/metadata/di.ts b/modules/@angular/core/src/metadata/di.ts
index 307ed6f30f..e1849bcd73 100644
--- a/modules/@angular/core/src/metadata/di.ts
+++ b/modules/@angular/core/src/metadata/di.ts
@@ -35,7 +35,7 @@ import {Type} from '../type';
  * // user code
  * let routes = [
  *   {path: '/root', component: RootComp},
- *   {path: /teams', component: TeamsComp}
+ *   {path: '/teams', component: TeamsComp}
  * ];
  *
  * @NgModule({
diff --git a/modules/@angular/core/src/metadata/directives.ts b/modules/@angular/core/src/metadata/directives.ts
index 9bba9fa383..1787d864ea 100644
--- a/modules/@angular/core/src/metadata/directives.ts
+++ b/modules/@angular/core/src/metadata/directives.ts
@@ -883,7 +883,7 @@ export class ComponentMetadata extends DirectiveMetadata implements ComponentMet
   styleUrls: string[];
 
   /**
-   * Specifies an inline stylesheet for an Angular component.
+   * Specifies inline stylesheets for an Angular component.
    */
   styles: string[];