Additional updates based on Ward's feedback, and more comments after I went through the last two pages of the tutorial.

Author: cfranger

public/docs/ts/latest/tutorial/index.jade

@@ -37,28 +37,28 @@ figure.image-display
   img(src='/resources/images/devguide/toh/heroes-dashboard-1.png' alt="Output of heroes dashboard")
 
 :marked
-  Users can click the two links above the dashboard ("Dashboard" and "Heroes") 
+  You can click the two links above the dashboard ("Dashboard" and "Heroes") 
   to navigate between this Dashboard view and a Heroes view.
 
-  If a user clicks the dashboard hero "Magneta," the router opens a "Hero Details" view
-  where the user can change the hero's name.
+  If you click the dashboard hero "Magneta," the router opens a "Hero Details" view
+  where you can change the hero's name.
 
 figure.image-display
   img(src='/resources/images/devguide/toh/hero-details-1.png' alt="Details of hero in app")
 
 :marked
-  Clicking the "Back" button returns users to the Dashboard.
-  Links at the top take them to either of the main views.
-  If a user clicks "Heroes," the app displays the "Heroes" master list view.
+  Clicking the "Back" button returns you to the Dashboard.
+  Links at the top take you to either of the main views.
+  If you click "Heroes," the app displays the "Heroes" master list view.
 
 figure.image-display
   img(src='/resources/images/devguide/toh/heroes-list-2.png' alt="Output of heroes list app")
 //  CF: The ability to add heroes isn't shown in the images or discussed in this page. Should that be added?
 
 :marked
-  When a user clicks a different hero name, the read-only mini detail beneath the list reflects the new choice.
+  When you click a different hero name, the read-only mini detail beneath the list reflects the new choice.
 
-  Users can click the "View Details" button to drill into the
+  You can click the "View Details" button to drill into the
   editable details of the selected hero.
 
   The following diagram captures all of the navigation options.

public/docs/ts/latest/tutorial/toh-pt1.jade

@@ -2,10 +2,12 @@ include ../_util-fns
 
 :marked
   ## Setup to develop locally
-  Application development takes place in a local development environment, like your machine.
-  
   Follow the [setup](../guide/setup.html) instructions for creating a new project
   named <ngio-ex path="angular-tour-of-heroes"></ngio-ex>.
+  <!-- CF: TO DO: Ward commented: if you only followed the current setup instructions, there would be many more files.
+  I just added a section to the Setup guide for deleting non-essential files. We should refer to that too.
+  See #3079 which will merge soon. The link to it would be:
+  [_Deleting non-essential files_](../guide/setup.html#non-essential "Setup: Deleting non-essential files") -->
   The file structure should look like this:
 
 .filetree
@@ -26,20 +28,21 @@ include ../_util-fns
   When you're done with this page, the app should look like this <live-example></live-example>.
 
   ## Keep the app transpiling and running
-  To start the TypeScript compiler in watch mode and start the server, type the following:
+  Enter the following command in the terminal window:
 
 code-example(language="sh" class="code-shell").
   npm start
 
 :marked
-  This command launches the app in a browser
-  and keeps the app running while you build the Tour of Heroes.
+  This command runs the TypeScript compiler in "watch mode", recompiling automatically when the code changes.
+  The command simultaneously launches the app in a browser and refreshes the browser when the code changes.
+  
+  You can keep building the Tour of Heroes without pausing to recompile or refresh the browser.
 
 .l-main-section
   :marked
-    ## Show your hero
-    To display hero data in the app,
-    add two properties to the `AppComponent`: a `title` property for the app name and a `hero` property
+    ## Show the hero
+    Add two properties to the `AppComponent`: a `title` property for the app name and a `hero` property
     for a hero named "Windstorm."
 
   +makeExample('toh-1/ts-snippets/app.component.snippets.pt1.ts', 'app-component-1', 'app.component.ts (AppComponent class)')(format=".")
@@ -52,8 +55,10 @@ code-example(language="sh" class="code-shell").
   :marked
     The browser refreshes and displays the title and hero name.
 
-    The double curly braces instruct the app to read the `title` and `hero` properties from the component and render them.
-    This is the "interpolation" form of one-way data binding.
+    The double curly braces are Angular's *interpolation binding* syntax.
+    These interpolation bindings present the component's `title` and `hero` property values,
+    as strings, inside the HTML header tags.
+
 .l-sub-section
   :marked
     Read more about interpolation in the [Displaying Data](../guide/displaying-data.html) page.
@@ -71,7 +76,7 @@ code-example(language="sh" class="code-shell").
 
 :marked
   In the `Hero` class, refactor the component's `hero` property to be of type `Hero`,
-  then initialize it with an ID of `1` and the name "Windstorm."
+  then initialize it with an id of `1` and the name `Windstorm`.
 
 +makeExample('toh-1/ts/app/app.component.ts', 'hero-property-1', 'app.component.ts (hero property)')(format=".")
 
@@ -87,16 +92,17 @@ code-example(language="sh" class="code-shell").
 
   To show all of the hero's properties,
   add a `<div>` for the hero's `id` property and another `<div>` for the hero's `name`.
-  To keep the template readable, use the template strings feature
-  in ES2015 and TypeScript:
-  change the quotes around the template to backticks
-  and put the `<h1>`, `<h2>`, and `<div>` elements on their own lines.
+  To keep the template readable, place each `<div>` on its own line.
+
+  The backticks around the component template let you put the `<h1>`, `<h2>`, and `<div>` elements on their own lines, 
+  thanks to the <i>template literals</i> feature in ES2015 and TypeScript. For more information, see 
+  <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template_literals" target="_blank" title="template literal">Template literals</a>.
 
 +makeExample('toh-1/ts-snippets/app.component.snippets.pt1.ts', 'multi-line-strings', 'app.component.ts (AppComponent\'s template)')
 
 .l-main-section
 :marked
-  ## Editing the hero name
+  ## Edit the hero name
 
   Users should be able to edit the hero name in a textbox.