docs(cookbook-aot-compiler): ward's tweaks to angular#2790

Author: wardbell

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

@@ -343,7 +343,7 @@ a#toh
 
   ***index.html***
 
-  The JiT and AoT apps are setup and launched so differently that they require their own `index.html` files. 
+  The JiT and AoT apps require their own `index.html` files because they setup and launch so differently. 
   Here they are for comparison:
 
 +makeTabs(
@@ -355,7 +355,8 @@ a#toh
 )
 
 :marked
-  They can't be in the same folder. 
+  They can't be in the same folder.
+
   ***Put the AoT version in the `/aot` folder***.
 
   The JiT version relies on `SystemJS` to load individual modules and requires the `reflect-metadata` shim. 
@@ -366,8 +367,8 @@ a#toh
 
   ***main.ts***
 
-  The JiT and AoT apps are also bootstraped differently that they require their own `main.ts` files. 
-  Here they are for comparison:
+  JiT and AoT apps boot in much the same way but require different Angular libraries to do so.
+  The differences are evident in these `main` files: 
 
 +makeTabs(
   `toh-6/ts/app/main-aot.ts,
@@ -378,17 +379,17 @@ a#toh
 )
 
 :marked
-  They can and should exist in the same folder.
+  Both `main` files can and should exist in the same folder.
 
   The `app/main-aot.ts` file is used by the AoT config scripts (`tsconfig-aot.json` and `rollup-config.js`).
 
-  Key differences are discussed in the [Bootstrap](#bootstrap) section, above.
+  The [Bootstrap](#bootstrap) section, above covers the key differences.
 
-  *Component-relative Template URLS*
+  ***Component-relative Template URLS***
 
   The AoT compiler requires that `@Component` URLS for external templates and css files be _component-relative_.
-  That means that the value of `@Component.templateUrl` is a URL value relative to the component class file:
-  `foo.component.html` no matter where `foo.component.ts` sits in the project folder structure.
+  That means that the value of `@Component.templateUrl` is a URL value _relative_ to the component class file.
+  The URL, `'foo.component.html'`, means that the template file is a sibling of its companion `foo.component.ts` file.
 
   While JiT app URLs are more flexible, stick with _component-relative_ URLs for compatibility with AoT compilation.
 
@@ -418,10 +419,13 @@ a#toh
 
 .l-sub-section
   :marked
-    _Note_ that the specific file structure of this project needs `typeRoots` to include `../../node_modules/@types/`, 
-    whereas in a typical setting it should include `node_modules/@types/` instead.
+    The file structure of this specific sample project 
+    happens to place the `node_modules` two levels up from the project root. 
+    Therefore, `typeRoots` must be `../../node_modules/@types/`. 
+    In a more typical project, `node_modules` would be a sibling of tsconfig-aot.json`
+    and `typeRoots` would be `node_modules/@types/`.
 
-    Make sure to edit accordingly to your project needs.
+    Edit your `tsconfig-aot.json` to fit your project's file structure.
 
 :marked
   ### Tree Shaking