docs(toh6): fix if-docs (#3116)

Fix: we can’t have a markdown `<span>` ranging over multiple
paragraphs; instead we use the `+ifDocsFor()` mixin.
This commit is contained in:
Patrice Chalin 2017-01-20 08:40:00 -08:00 committed by Filipe Silva
parent 276867e899
commit a25842009e
1 changed files with 11 additions and 7 deletions

View File

@ -401,6 +401,7 @@ block observables-section-intro
It's easy with *!{_Observable}s* as we'll see. It's easy with *!{_Observable}s* as we'll see.
### Search-by-name ### Search-by-name
We're going to add a *hero search* feature to the Tour of Heroes. We're going to add a *hero search* feature to the Tour of Heroes.
As the user types a name into a search box, we'll make repeated HTTP requests for heroes filtered by that name. As the user types a name into a search box, we'll make repeated HTTP requests for heroes filtered by that name.
@ -412,15 +413,17 @@ block observables-section-intro
The `!{_priv}http.get()` call in `HeroSearchService` is similar to the one The `!{_priv}http.get()` call in `HeroSearchService` is similar to the one
in the `HeroService`, although the URL now has a query string. in the `HeroService`, although the URL now has a query string.
<span if-docs="ts">A more important difference: we no longer call `toPromise`. +ifDocsFor('ts')
:marked
A more important difference: we no longer call `toPromise`.
Instead we return the *observable* from the the `htttp.get`, Instead we return the *observable* from the the `htttp.get`,
after chaining it to another RxJS operator, <code>map</code>, after chaining it to another RxJS operator, <code>map</code>,
to extract heroes from the response data. to extract heroes from the response data.
RxJS operator chaining makes response processing easy and readable. RxJS operator chaining makes response processing easy and readable.
See the [discuss below about operators](#rxjs-imports). See the [discuss below about operators](#rxjs-imports).
</span>
:marked
### HeroSearchComponent ### HeroSearchComponent
Let's create a new `HeroSearchComponent` that calls this new `HeroSearchService`. Let's create a new `HeroSearchComponent` that calls this new `HeroSearchService`.
@ -513,6 +516,7 @@ block observable-transformers
a#rxjs-imports a#rxjs-imports
:marked :marked
### Import RxJS operators ### Import RxJS operators
Most RxJS operators are not included in Angular's base `Observable` implementation. Most RxJS operators are not included in Angular's base `Observable` implementation.
The base implementation includes only what Angular itself requires. The base implementation includes only what Angular itself requires.