docs(toh-5): TS/Dart review, and Dart resync

[chalin]

NOTE: run gulp add-example-boilerplate after pulling in the commit.

This PR has two major commits:

1. Post-RC5 resync
2. Edits after having done the tutorial.

Lint reports no errors and e2e tests pass.

1. Commit: TS review and update/resync Dart

This is preparatory work for #2035. As part of the chapter review, the Dart .jade was enhanced to use Jade extends (#2108). These edits also contributed to a post-RC5 resync (#2077). Other key changes:

Dart and TS code:

• Eliminated styles.1.css in favor of docregions in styles.css.
• docregion tags renamed in a few places.
• No other code changes.

Dart code:

• Include renamed constructor name in "renamings" figure.

TS prose

• Fix: HeroesComponent was being added twice.
• All other changes are minor copy edits, or changes to support Dart via Jade extends.

Diff of generated HTML for TS chapter was inspected to ensure only minor copy edits prevailed (i.e., that the support for Jade extends had no impact on the generated HTML).

2. Commit: edits after doing tutorial

• Some adjustments following actually doing the tutorial. In some cases code shown (e.g. this is what file foo should look like now) didn't match what the user would have. E.g., lingering @input on the hero property.
• Added extra step to app.component.ts creation rather than having a critical-call-out later on.
• TS-side: fixed some lingering deprecated-router prose elements (e.g., still referring to a route by the old string names like HeroDetail).
• Reorder some prose for better harmony between TS and Dart prose (also improves the flow).
• Moved the styleUrls call-out to the point of first use.

[chalin]

@wardbell @Foxandxss @brandonroberts @kwalrath: ready for review.

As usual, Jade files are best viewed by ignoring whitespace.

[chalin]

cc @kapunahelewong -- I included some of your copy edits, but mostly left my revision as is. I think that some / most of your concerns were addressed; others not (e.g. adding a complete set of new/changed files at the end of the chapter -- I was missing that too, but I can let you make the addition :).

[kwalrath]

I wondered about having two @Component annotations for a single class. Sure enough, when I try to pub serve or pub build this, I get a build error:

Build error:
Transform DirectiveProcessor on angular2_tour_of_heroes|lib/app_component_1.dart threw error: Only one Directive is allowed per class. Found unexpected "@Component(selector: 'my-app', template: '''
      <h1>{{title}}</h1>
      <a [routerLink]="['Heroes']">Heroes</a>
      <router-outlet></router-outlet>''', directives: const [HeroesComponent], providers: const [HeroService])".
@Component(selector: 'my-app', template: '''
      <h1>{{title}}</h1>
     ...

Does the serve/build work without errors for you?

[chalin]

Fixing that now.

[kwalrath]

This is an excerpt but has no "..." to indicate that code is missing. (It's missing imports, the OnInit implementation, @Component, ...)

[kwalrath]

I guess I'd either use the "..." or find another way to make clear that you need to import dart:html to gain access to window.

[chalin]

Added:

We'll also need to import dart:html to gain access to window.

import 'dart:html';

[kwalrath]

LGTM!

[Foxandxss]

LGTM