post-review updates

Author: chalin

public/docs/_examples/dependency-injection/dart/lib/app_component.dart

@@ -1,15 +1,10 @@
-// #docplaster
-// #docregion
-// #docregion imports
 import 'package:angular2/core.dart';
 
 import 'app_config.dart';
 import 'car/car_component.dart';
 import 'heroes/heroes_component.dart';
 import 'logger_service.dart';
 import 'user_service.dart';
-//PENDING: check whether we intend to hide injector_component.dart & providers_component.dart; if so, change docregion name?
-// #enddocregion imports
 import 'injector_component.dart';
 import 'test_component.dart';
 import 'providers_component.dart';
@@ -62,6 +57,6 @@ class AppComponent {
     return _userService.user;
   }
 
-  String get userInfo => 'Current user, ${user.name}, is'
-      '${isAuthorized ? "" : " not"} authorized. ';
+  String get userInfo => 'Current user, ${user.name}, is' +
+    (isAuthorized ? '' : ' not') + ' authorized. ';
 }

public/docs/_examples/dependency-injection/dart/lib/logger_service.dart

@@ -4,7 +4,6 @@ import 'package:angular2/core.dart';
 @Injectable()
 class Logger {
   List<String> _logs = [];
-
   List<String> get logs => _logs;
 
   void log(String message) {

public/docs/ts/latest/guide/dependency-injection.jade

@@ -34,7 +34,7 @@ p Run the #[+liveExampleLink2()].
 
   Our `Car` needs an engine and tires. Instead of asking for them,
   the `Car` constructor instantiates its own copies from
-  the very specific classes, `Engine` and `Tires`.
+  the very specific classes `Engine` and `Tires`.
 
   What if the `Engine` class evolves and its constructor requires a parameter?
   Our `Car` is broken and stays broken until we rewrite it along the lines of
@@ -422,9 +422,9 @@ block injectable-not-always-needed-in-ts
 
   We *can* add it if we really want to. It isn't necessary because the
   `HeroesComponent` is already marked with `@Component`, and this
-  !{_decorator} class (like `@Directive` and `@Pipe` which we will study later
-  on) is a subtype of <a href="#{injMetaUrl}">InjectableMetadata</a>.  It is in
-  fact <a href="#{injMetaUrl}">InjectableMetadata</a> #{_decorator}s that
+  !{_decorator} class (like `@Directive` and `@Pipe`, which we'll learn about later)
+  is a subtype of <a href="#{injMetaUrl}">InjectableMetadata</a>.  It is in
+  fact `InjectableMetadata` #{_decorator}s that
   identify a class as a target for instantiation by an injector.
 
 block ts-any-decorator-will-do
@@ -701,7 +701,7 @@ block dart-diff-const-metadata-ctor
 +makeTabs(
   `dependency-injection/ts/app/heroes/heroes.component.ts,
   dependency-injection/ts/app/heroes/heroes.component.1.ts`,
-  null,
+  ',full',
   `app/heroes/heroes.component (v3),
   app/heroes/heroes.component (v2)`,
   stylePattern)
@@ -813,16 +813,17 @@ block dart-map-alternative
 
   Our `HeroService` *requires* a `Logger`, but what if it could get by without
   a logger?
-  As is illustrated next, we can indicate that to the dependency injection
-  framework by marking the constructor's argument as optional.
+  We can tell Angular that the dependency is optional by annotating the 
+  constructor argument with `@Optional()`:
 
 +ifDocsFor('ts')
   +makeExample('dependency-injection/ts/app/providers.component.ts','import-optional', '')
 +makeExample('dependency-injection/ts/app/providers.component.ts','provider-10-ctor', '')(format='.')
 
 :marked
-  Be prepared for a null logger. If we don't register one somewhere up the line,
-  the injector will inject `null`.
+  When using `@Optional()`, our code must be prepared for a null value. If we
+  don't register a logger somewhere up the line, the injector will set the
+  value of `logger` to null.
 
 .l-main-section
 :marked