Skip to content
This repository was archived by the owner on Dec 4, 2017. It is now read-only.

docs(toh-6): add hero search to Dart; minor edits to TS #2018

Merged
merged 4 commits into from
Aug 2, 2016

Conversation

chalin
Copy link
Contributor

@chalin chalin commented Aug 2, 2016

TS minor edits:

Dart update:

Note: in anticipation of #1751, sample.css has been eliminated from the Dart example.

@@ -135,21 +135,21 @@ block get-heroes-details

For *now* we get back on familiar ground by immediately by
converting that `Observable` to a `Promise` using the `toPromise` operator.
+makeExample('toh-6/ts/app/hero.service.ts', 'to-promise')(format=".")
+makeExcerpt('app/hero.service.ts', 'to-promise')
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not crazy about adding the big blue title to all the one-line examples. It gives the source of the code more weight than the actual code.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oups, didn't mean for that to happen. I forgot that the convention for including/excluding a title with makeExcerpt is reversed as compared to makeExample. Fixed all of excerpts that originally did not have a title.

@chalin
Copy link
Contributor Author

chalin commented Aug 2, 2016

@kwalrath : updates pushed.

:marked
Fortunately, there are stream transformers that will help us reduce the request flow.
We'll make fewer calls to the `HeroSearchService` and still get timely results. Here's how:
starting from the underlying stream of search terms we
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This line looks weird and ungrammatical. Can we just delete it?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Deleted.

@kwalrath
Copy link
Contributor

kwalrath commented Aug 2, 2016

Some minor issues, but otherwise looks great!

@kwalrath
Copy link
Contributor

kwalrath commented Aug 2, 2016

LGTM

@kwalrath kwalrath merged commit 8a6c5b5 into angular:master Aug 2, 2016
@kwalrath kwalrath deleted the chalin-toh-6-hero-search-0728 branch August 2, 2016 16:59
chalin added a commit to IdeaBlade/angular.io that referenced this pull request Aug 14, 2016
**NOTE: run `gulp add-example-boilerplate` after pulling in the
commit.**

This is preparatory work for angular#2035.
As part of the the chapter review, the Dart .jade was enhanced to use
Jade extends (angular#2018).
By the same token it contributed to a post-RC5 resync (angular#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**.

TS prose
- Fixed: misnamed variable `routing` -> `appRoutes`.
- 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).
chalin added a commit to IdeaBlade/angular.io that referenced this pull request Aug 17, 2016
**NOTE: run `gulp add-example-boilerplate` after pulling in the
commit.**

This is preparatory work for angular#2035.
As part of the the chapter review, the Dart .jade was enhanced to use
Jade extends (angular#2018).
By the same token it contributed to a post-RC5 resync (angular#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**.

TS prose
- Fixed: misnamed variable `routing` -> `appRoutes`.
- 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).
kwalrath pushed a commit that referenced this pull request Aug 17, 2016
* docs(toh-5): review and update/resync Dart

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

This is preparatory work for #2035.
As part of the the chapter review, the Dart .jade was enhanced to use
Jade extends (#2018).
By the same token it 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**.

TS prose
- Fixed: misnamed variable `routing` -> `appRoutes`.
- 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).

* docs(toh-5): 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.
- Fixed some lingering deprecated-router prose elements on TS side (e.g., still referring to a route by the old string names like `HeroDetail`).
- Added extra step to `app.component.ts` creation rather than having a critical-call-out later on.
- 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.

* post-review changes

* more post-review changes

* toh-6 cache update
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[Dart] ToH-6 updates following addition of Observables section on TS side
3 participants