[WIP] docs(testing): new chapter, new samples

[wardbell]

WIP Do not merge
Totally revised testing chapter for RC5 and beyond.

[Foxandxss]

s/our/your?

[juliemr]

system-config-extras doesn't seem to be loading properly, I don't know the setup of .io enough to know if this is a real issue :)

[juliemr]

In a lot of places where you say "test class" when discussing what the TestBed creates, I think it would be clearer to say "test component".

Ward sez: Great idea. Fixed

[juliemr]

In the AutoDetect spec, it would be helpful to show the imports so the user can see where ComponentFixtureAutoDetect comes from.

Ward sez: I am conflicted about this. I deliberately left out all import statements so that people can focus on the code and the ideas. I feel this is OK because the full code is readily available in the plunkers.

I could be persuaded to change my mind. But including all the imports will often almost double the example size and I'm not keen on that. Thinking.

[juliemr]

fixture.whenStable pops up without introduction when it's first used, maybe we should add an intro for it.

EDIT: nevermind, I see the follow-up commentary.

[Foxandxss]

DashboardComponent

[wardbell]

@Foxandxss and @juliemr Thanks for your feedback. I believe I have incorporated all of it. My only point of disagreement is about whether to show import statements in the extracts.

As I explained above, I am reluctant to do so because I feel that it distracts from the code. Someone who wants to know where those thing actually come from can see that in a heartbeat by looking at the full code in the plunker.

I don't know that I'm "right" about this choice. I can only say that I think I have a good reason. Let's see what our audience thinks.

Thanks so much!

p.s.: I know this is incomplete. I have many more sections to go. I hope it is a good enough start.

[juliemr]

One more comment - this implies that async and fakeAsync are tied to the TestBed, which isn't true. async and fakeAsync are completely distinct from the test module and its setup, and can be used without it, or vice versa. I think the section labeled TestBed API should probably be called Angular Test Helper API or something of the sort.

[juliemr]

Other than that, this looks like a great start to me!