docs(toh-6-aot): add aot to toh-6

Author: thelgevold

public/docs/_examples/_boilerplate/tsconfig.json

@@ -13,6 +13,6 @@
   },
   "exclude": [
     "node_modules/*",
-    "*.-aot.ts"
+    "**/*-aot.ts"
   ]
 }

public/docs/_examples/cb-aot-compiler/ts/app/app.component.ts

@@ -13,5 +13,4 @@ export class AppComponent {
   toggleHeading() {
     this.showHeading = !this.showHeading;
   }
-
 }

public/docs/_examples/cb-aot-compiler/ts/index.html

@@ -9,7 +9,6 @@
 
     <script src="node_modules/core-js/client/shim.min.js"></script>
     <script src="node_modules/zone.js/dist/zone.js"></script>
-    <script src="node_modules/reflect-metadata/Reflect.js"></script>
 
   </head>
 

public/docs/_examples/toh-6-aot/ts/index.html

@@ -5,13 +5,10 @@
     <base href="/">
     <title>Angular Tour of Heroes</title>
     <meta name="viewport" content="width=device-width, initial-scale=1">
-
     <link rel="stylesheet" href="styles.css">
 
     <script src="node_modules/core-js/client/shim.min.js"></script>
-
     <script src="node_modules/zone.js/dist/zone.js"></script>
-
     <!-- #docregion moduleId -->
     <script>window.module = 'aot';</script>
     <!-- #enddocregion moduleId -->

public/docs/_examples/tsconfig.json

@@ -20,9 +20,5 @@
   ],
   "include": [
     "*/e2e-spec.ts"
-  ],
-  "exclude": [
-    "**/node_modules/*",
-    "*.-aot.ts"
   ]
 }

public/docs/ts/latest/cookbook/aot-compiler.jade

@@ -78,14 +78,21 @@ a#aot-jit
   The AoT compiler detects and reports template binding errors during the build step
   before users can see them.
 
+
+  *Better security*
+
+  AoT compiles HTML templates and components into JavaScript files long before they are served to the client.
+  With no templates to read and no risky client-side HTML or JavaScript evaluation,
+  there are fewer opportunities for injection attacks.
+
 a#compile
 .l-main-section
 :marked
   ## Compile with AoT
 
   ### Prepare for offline compilation
 
-  This cookbook takes the <a href='/docs/ts/latest/quickstart.html'>QuickStart</a> as its starting point.
+  Take the <a href='/docs/ts/latest/quickstart.html'>QuickStart</a> as a starting point.
   A few minor changes to the lone `app.component` lead to these two class and html files:
 
 +makeTabs(
@@ -94,7 +101,7 @@ a#compile
   null,
   `app/app.component.html,
    app/app.component.ts`
-)
+)(format='.')
 
 :marked
   Install a few new npm dependencies with the following command: 
@@ -218,8 +225,9 @@ a#tree-shaking
 code-example(format='.').
   npm install rollup rollup-plugin-node-resolve rollup-plugin-commonjs rollup-plugin-uglify --save-dev
 :marked
-  Next, create a configuration file to tell Rollup how to process the application. 
-  The configuration file in this cookbook is named `rollup-config.js` and looks like this.
+  Next, create a configuration file (`rollup-config.js`)
+  in the project root directory to tell Rollup how to process the application. 
+  The cookbook configuration file looks like this.
 
 +makeExample('cb-aot-compiler/ts/rollup-config.js', null, 'rollup-config.js')(format='.')
 :marked
@@ -298,9 +306,9 @@ code-example(format='.').
 a#source-code
 .l-main-section
 :marked
-  ## Source Code
+  ## AoT QuickStart Source Code
 
-  Here is the pertinent AoT source code for this cookbook so far:
+  Here's the pertinent source code:
 +makeTabs(
   `cb-aot-compiler/ts/app/app.component.html,
    cb-aot-compiler/ts/app/app.component.ts,
@@ -341,16 +349,16 @@ a#toh
   Both scripts appear in its `index.html`.
 
   The AoT version loads the entire application in a single script, `dist/build.js`.
-  It has no need for the `SystemJS` or `reflect-metadata` shim whose scripts are absent from its `index.html`
+  It does not need `SystemJS` or the `reflect-metadata` shim; those scripts are absent from its `index.html`
 
   Here are the two index.html files for comparison:
 
 +makeTabs(
-  `toh-6/ts/index.html,
-   toh-6-aot/ts/index.html`,
+  `toh-6-aot/ts/index.html,
+   toh-6/ts/index.html`,
   null,
-  `index.html (JiT),
-   index.html (AoT)`
+  `index.html (AoT),
+   index.html (JiT)`
 )
 
 :marked
@@ -379,11 +387,11 @@ a#toh
   You'll need separate TypeScript configuration files such as these:
 
 +makeTabs(
-  `toh-6/ts/tsconfig.json,
-   toh-6/ts/tsconfig-aot.json`,
+  `toh-6/ts/tsconfig-aot.json,
+   toh-6/ts/tsconfig.json`,
   null,
-  `tsconfig.json (JiT),
-   tsconfig-aot.json (AoT)`
+  `tsconfig.json (AoT),
+   tsconfig-aot.json (JiT)`
 )   
 
 :marked

public/docs/ts/latest/guide/change-log.jade

@@ -7,6 +7,12 @@ block includes
   The Angular documentation is a living document with continuous improvements.
   This log calls attention to recent significant changes.
 
+  ## NEW "Ahead of Time (AoT) Compilation" cookbook (2016-10-11)
+  The NEW [Ahead of Time (AoT) Compilation](../cookbook/aot-compiler.html) cookbook
+  explains what AoT compilation is and why you'd want it.
+  It demonstrates the basics with a QuickStart app
+  followed by the more advanced considerations of compiling and bundling the Tour of Heroes.
+
   ## Sync with Angular v.2.0.2 (2016-10-6)
   Docs and code samples updated and tested with Angular v.2.0.2