post-review changes

Author: chalin

public/docs/_examples/toh-6/dart/web/main.dart

@@ -3,22 +3,27 @@
 // #docregion v1
 import 'package:angular2/core.dart';
 import 'package:angular2/platform/browser.dart';
-import 'package:http/http.dart';
 import 'package:angular2_tour_of_heroes/app_component.dart';
 // #enddocregion v1
+import 'package:http/http.dart';
 import 'package:angular2_tour_of_heroes/in_memory_data_service.dart';
 
 void main() {
-  bootstrap(AppComponent, const [
-    const Provider(Client, useClass: InMemoryDataService)
-  ]);
+  bootstrap(AppComponent,
+      const [const Provider(Client, useClass: InMemoryDataService)]);
 }
 // #enddocregion final
 /*
 // #docregion v1
+import 'package:http/browser_client.dart';
 
 void main() {
-  bootstrap(AppComponent, const [BrowserClient]);
+  bootstrap(AppComponent, [
+    provide(BrowserClient, useFactory: () => new BrowserClient(), deps: [])
+  ]);
+  // Simplify bootstrap provider list to [BrowserClient]
+  // once there is a fix for:
+  // https://github.com/angular/angular/issues/9673
 }
 // #enddocregion v1
 */

public/docs/dart/latest/tutorial/toh-pt6.jade

@@ -5,7 +5,7 @@ block includes
   - var _Http = 'BrowserClient';
   - var _Angular_Http = 'Dart <code>BrowserClient</code>'
   - var _httpUrl = 'https://pub.dartlang.org/packages/http'
-  - var _Angular_http_library = 'Dart <a href="' + _httpUrl + '"><b>http</b></a> library'
+  - var _Angular_http_library = 'Dart <a href="' + _httpUrl + '"><b>http</b></a> package'
   - var _HTTP_PROVIDERS = 'BrowserClient'
   - var _JSON_stringify = 'JSON.encode'
 
@@ -20,22 +20,23 @@ block start-server-and-watch
 
 block http-library
   :marked
-    We'll be using the !{_Angular_Http} to communicate with a server.
-    This class is exported by the !{_Angular_http_library}.
+    We'll be using the !{_Angular_http_library}'s 
+    `BrowserClient` class to communicate with a server.
 
     ### Pubspec updates
 
     We need to add a package dependency for the !{_Angular_http_library}.
 
-    We also need to inform the Dart Angular 2 Transformer that we will be using
-    `BrowserClient` (we'll defer explaining _why_ this extra configuration is
-    needed until the [HTTP client chapter](../guide/server-communication.html#!#http-providers))
-    by means of the transformer's `resolved_identifiers` configuration parameter.
-    Since we will also be needing the !{_Angular_http_library} `Client` interface, we'll
-    add that now as well.
+    We also need to add a `resolved_identifiers` entry, to inform the [angular2
+    transformer][ng2x] that we'll be using `BrowserClient`. (For an explanation of why
+    this extra configuration is needed, see the [HTTP client chapter][guide-http].) We'll
+    also need to use `Client` from http, so let's add that now as well.
 
     Update `pubspec.yaml` to look like this (additions are highlighted):
 
+    [guide-http]: ../guide/server-communication.html#!#http-providers
+    [ng2x]: https://github.com/angular/angular/wiki/Angular-2-Dart-Transformer
+
   - var stylePattern = { pnk: /(http.*|resolved_identifiers:|Browser.*|Client.*)/gm };
   +makeExcerpt('pubspec.yaml', 'additions', null, stylePattern)
 
@@ -48,7 +49,7 @@ block backend
     We want to replace `BrowserClient`, the service that talks to the remote server,
     with the in-memory web API service. 
     Our in-memory web API service, shown below, is implemented using the
-    standard `http` library `MockClient` class.
+    `http` library `MockClient` class.
     All `http` client implementations share a common `Client` interface, so
     we'll have our app use the `Client` type so that we can freely switch between
     implementations.
@@ -58,9 +59,9 @@ block dont-be-distracted-by-backend-subst
 
 block get-heroes-details
   :marked
-    We make an asynchronous call to `http.get()` which returns an HTTP
-    `Response`.  The response payload (`body`) is decoded as JSON via the
-    `_extractData` helper method.
+    To get the list of heroes, we first make an asynchronous call to
+    `http.get()`. Then we use the `_extractData` helper method to decode the
+    response payload (`body`).
 
 block hero-detail-comp-extra-imports-and-vars
   //- N/A
@@ -70,7 +71,8 @@ block hero-detail-comp-updates
     ### Edit in the *HeroDetailComponent*
 
     We already have `HeroDetailComponent` for viewing details about a specific hero. 
-    Supporting edit functionality is natural extensions of the detail view, so we are able to reuse `HeroDetailComponent` with a few tweaks. 
+    Supporting edit functionality is a natural extension of the detail view,
+    so we are able to reuse `HeroDetailComponent` with a few tweaks.
 
 block hero-detail-comp-save-and-goback
   //- N/A