Commit Graph

53 Commits

Author SHA1 Message Date
Patrice Chalin e9a6001d60 docs(toh-6): copyedits (#3434)
- Remove statement that doesn't apply: "We recommend registering
app-wide services in the root
  `AppModule` *providers*" - but that isn't being done.
- Adding parentheses after method names; a few were missed in the
previous pass.
- `debounce()` --> `debounceTime()`
- Remove obsolete Dart prose.
- Fix heading indentation.
- Added missing closing `</span>`.
- Fix misnamed Jade variables.

cc @kapunahelewong
2017-03-30 09:39:48 -07:00
Kapunahele Wong a705a0ca3c docs(toh): copy edit and fixes in 4, 5, 6 and example (#3412) 2017-03-23 15:47:55 -07:00
Ward Bell 0fc40284dd [WIP] docs(toh): copyedits to conform to Google doc standards (#3032) (#3077) 2017-03-21 11:08:09 -07:00
Michael Foss 9403dc0482 docs(toh): remove duplicate "the" (#3321) 2017-03-01 00:52:52 +01:00
Jesús Rodríguez 11701c009f chore: fix a few standing typos (#3280) 2017-02-21 17:45:02 -10:00
Filipe Silva 1101f07ef2 refactor: add src folder (#3171)
* boilerplate, gulpfile, quickstart

* move ts files up to cookbooks

* move rest of ts files

* fix tsconfig, default build task, json file

* fix js examples

* fix webpack example

* remove a2docs.css references

* fix aot examples

* fix webpack run task

* fix cb-i18n

* fix upgrade examples

* fix unit tests

* fix comment in deployment index

* removed unused typings.json

* fix plunkers

* fix js example paths

* fix ts quickstart/setup prose

* add src folder note to setup

* broadly replace app/ -> src/app/

* broadly replace main.ts

* broadly replaced index.html

* broadly replace tsconfig

* replace systemjs

* fix filetrees

* Minor prose fixes to aot, i18n cookbooks

* remove char harp was complaining about

* update new reactive forms example

* fix quickstart jade error

* fix mistakes uncovered by CI

* fix bad filename errors

* edit style guide 04-06 rule to use src

* add changelog

* Incorporate Jesus's feedback

* fix snippet headers in toh1/2

* chore: tweak changelog and setup text
2017-02-02 19:38:17 +01:00
Patrice Chalin a25842009e docs(toh6): fix if-docs (#3116)
Fix: we can’t have a markdown `<span>` ranging over multiple
paragraphs; instead we use the `+ifDocsFor()` mixin.
2017-01-20 16:40:00 +00:00
Ward Bell aa6f503331 docs: remove rxjs-extensions in favor of explict imports (#3075)
Triggered by #2620 which it closes.
2017-01-05 01:12:06 -08:00
Ward Bell 9cf71d4b00 docs(http/toh-6): improve references to in-mem-web-api (#2964) 2016-12-13 02:18:07 -08:00
Patrice Chalin 499d4b3c88 docs(toh-6/dart): getHero makes HTTP get-by-id (#2936)
Dart follow-up to #2906
2016-12-06 15:28:34 -08:00
Patrice Chalin c7717b4850 docs(toh): fix code-example format and Dart code excerpt (#2907)
* ensure HeroesComponent renaming doesn't show router

* use code-example format consistent with the rest of the docs
2016-12-01 08:15:04 -08:00
Ward Bell 1d5e7c30be docs(toh-6): getHero makes HTTP get-by-id request (#2906) 2016-11-29 15:41:15 -08:00
Ward Bell ec2e6cb2c7 [WIP] docs(quickstart): QuickStart reboot (#2762) 2016-11-21 17:36:16 -08:00
Ward Bell a7525721c0 Revert "[WIP] docs(quickstart): QuickStart reboot (#2762)"
This reverts commit 8ccc33e6ff.
2016-11-21 17:29:00 -08:00
Ward Bell 8ccc33e6ff [WIP] docs(quickstart): QuickStart reboot (#2762) 2016-11-21 17:13:21 -08:00
Patrice Chalin 0dfda08306 docs: in links use href=foo#bar not foo#!#bar (#2807) 2016-11-15 15:36:34 -08:00
Patrice Chalin c12d75a477 remove redundant headings 2016-11-14 05:23:35 -08:00
Filipe Silva 0d49fecd30 chore: update to @types (#1872)
* chore: update examples to @types
* fix toh-6 aot and add types link
2016-10-20 17:01:16 -07:00
Sebastián Ramírez 883a29ecf7 Fix minor typo in HTTP guide (#2604) 2016-10-14 12:35:28 +02:00
Ward Bell 2e17d587de docs(toh-5): add AppRoutingModule (#2584) 2016-10-11 16:30:30 -07:00
Brandon ff118810ff docs(router): Updated routing examples to use routing modules (#2478)
Simplified routing in tutorial example

Updated ngmodule guide and ngmodule faq with routing module prose
2016-10-05 14:59:09 -07:00
Patrice Chalin b2c6acf1ad docs(tutorial): fix broken link (#2420)
Fixes #2419
2016-09-20 10:56:38 -07:00
Jesús Rodríguez 693f6ae462 chore: rename Angular 2 to simply Angular (#2402) 2016-09-19 20:24:40 -07:00
Ward Bell 6ff9e1a5c1 docs(toh-6): missing create instruction (#2264)
fixes #2231
also addresses `<h1>` issue raised in PR #2256
2016-09-03 13:46:27 -07:00
Patrice Chalin 907f848c95 docs(toh-6): refactoring of 'add, edit, delete heroes' (#2170)
* docs(toh-6/dart): refactoring of 'add, edit, delete heroes'

Refactoring of "add, edit, delete heroes" section of toh-6 from one big
bottom-up step into small independent feature slices, where the user
achieves a "milesone" (i.e., can run the full app) after each feature
section. The section rewrite is shorter and offers a better UX.

Other simplifications:
- Error handling is consistent: in the hero service we log to the
console, everwhere else we just let errors bubble up.
- Hero service methods renamed based on function (create, update)
rather then lower-level implementation (post, put).
- @Output properties have been eliminated (since they weren't
explained).

E2E tests now pass on both the TS and Dart sides.

* docs(toh-6/ts): refactoring of 'add, edit, delete heroes'

Refactoring of "add, edit, delete heroes" section of toh-6 from one big
bottom-up step into small independent feature slices, where the user
achieves a "milesone" (i.e., can run the full app) after each feature
section. The section rewrite is shorter and offers a better UX.

Other simplifications:
- Error handling is consistent: in the hero service we log to the
console, everwhere else we just let errors bubble up.
- Hero service methods renamed based on function (create, update)
rather then lower-level implementation (post, put).
- @Output properties have been eliminated (since they weren't
explained).

E2E tests now pass on both the TS and Dart sides.

Post-Dart-review updates included.

* docs(toh-6): ward tweaks
2016-08-26 14:57:45 -07:00
Brandon Roberts 5c5c9ca16c fix(toh-5): Fixed issues in tutorial flow
The HeroDetailComponent should be in the module declarations from the beginning.
InMemoryWebApiModule.forRoot(InMemoryDataService) and correct text
2016-08-19 03:43:00 -07:00
Patrice Chalin 9869bf585d docs(toh-6): systemjs.config.json -> systemjs.config.js (#2116)
Copyedit in file tree.
2016-08-17 11:11:50 -07:00
Patrice Chalin dfd46af604 docs(toh-6): post-RC5 Dart resync and TS fixes (#2095)
* toh-6: trim spaces from cache file to simplify diff

* toh-6: copy latest over cache before editing latest

* docs(toh-6): post-RC5 Dart resync and TS fixes

Contributes to #2077.

TS-side changes include:
- Merged three versions of `app/app.module{,1,2}.ts` into a single file
and used docregions instead.
- Misnamed files:
  - `rxjs-operators.ts` -> `rxjs-extensions.ts`
  - `hero-search.service.html` -> `hero-search.component.html`
- Fixed BAD FILENAME error.

Lint reports no errors and toh-6 e2e tests pass.
2016-08-12 11:21:16 -07:00
Peter Bacon Darwin d79adb2422 docs(rc5): update docs and plunkers for rc5 2016-08-09 11:48:07 -07:00
Adam d26afa90fd docs(toh-6): Move styles from sample.css to heroes.component.css
closes #1751
Move additional styles from `sample.css` to `hero-search.component.css`.
Edit tutorial to reflect the removal of `sample.css` and the change to `heroes.component.css`.
Edit tutorial to reflect the addition of `hero-search.component.css` file.
Edit `hero-search.component.ts` to include styles from `hero-search.component.css`.
Remove reference to `/public/docs/_examples/toh-6/ts/sample.css` from `/public/docs/_examples/toh-6/ts/index.html`.
2016-08-05 16:45:53 -07:00
Patrice Chalin 8a6c5b5725 docs(toh-6): add hero search to Dart; minor edits to TS (#2018)
* docs(toh-6/dart): add hero search

Fixes #1924.

* docs(toh-6/ts): minor updates

* post-review updates

* post-review updates
2016-08-02 09:59:35 -07:00
Patrice Chalin 04d5337b75 docs(toh-6): search query fixes
closes #2008
Changes:
- Drop `asObservable()` since it is deprecated in RxJS 5 (see the
[migration
guide](https://github.com/ReactiveX/RxJS/blob/master/MIGRATION.md#operat
ors-renamed-or-removed)).
- Drop `+` from hero search query URL: `app/heroes/?name=${term}+`. At
best it is interpreted as a regex op that serves no purpose, at worst,
it gets interpreted as a space (cf. [HTML 4.01 section
17.13.4](https://www.w3.org/TR/REC-html40/interact/forms.html#h-17.13.4)
).
- Rename `searchSubject` to `searchTerms`
- Other minor tweaks to prose.

This work is in preparation for #1924.

Note: toh-6 tests pass.
2016-08-01 11:50:53 -07:00
Jesús Rodríguez 4507589e26 docs(toh): add explanation for using the search box
closes #2002
2016-07-29 12:44:20 -07:00
Torgeir Helgevold f00b96fab8 docs(toh-6): remove details about throw 2016-07-19 22:48:55 -04:00
Patrice Chalin b4c92d9c9c docs(toh-6/dart): quickfix to "BAD FILENAME" errors (#1929)
Exclude the new Observables section entirely for now.
2016-07-19 15:30:42 -07:00
Ward Bell ce2e14e4ae docs(toh-pt6): bind to a component method rather than a RxJS Subject
updated text accordingly
2016-07-19 12:26:14 -07:00
Torgeir Helgevold f50dff818a docs(toh-pt6): add observables to HTTP tutorial chapter
closes #1528
2016-07-18 23:12:44 -07:00
Patrice Chalin b0e0d94b5c docs: revert Jade to markdown
closes #1818
Previously, the markdown of some chapters was converted to Jade markup
to support the conditional exclusion of TS prose parts in Dart
chapters. This commit reverts some of that back to clean markdown,
thanks to a few custom directives.
2016-07-05 23:03:30 -07:00
Brandon Roberts 97fbda0d76 docs(toh-6/ts): Upgraded http tutorial to use new router 2016-06-28 13:03:04 -07:00
Patrice Chalin 3fe0fb077c docs(toh-6/ts): minor edits and enhancements (#1686)
* docs(toh-6/ts): minor edits and enhancements

Changes to prose:

- Complete TODO item of displaying `heroes.component` errors.
- Mainly copyedits.
- Add of blocks statements so that prose can be used on Dart side.
- Show excerpt and briefly explain of changes (previously missing):
  - `app/hero-detail.component.html`
  - `app/heroes.component.ts` error handling
- Add missing file to changed/added files listing and makeTabs
  - `toh-6/ts/app/in-memory-data.service.ts,
  - `toh-6/ts/sample.css`

Code changes:

- Mainly copyedits
- Renamed `heroes.component.ts` `delete` to `deleteHero` to match
naming of other methods

* remove unnecessary change relative to toh-5
2016-06-27 11:23:27 -07:00
Helmi 7f256eea75 Fix typo in 'Simulating the web api' section.
closes #1655
2016-06-13 11:05:15 -07:00
Foxandxss 61ad427319 docs(toh): add missing snippets
closes #1649
2016-06-13 10:46:53 -07:00
Patrice Chalin 7e52648ee7 docs(toh): update live example links (#1602) 2016-06-07 15:51:25 -07:00
jevonearth f7cf6fde9f docs(toh-6): Fix typo in 'Add/Delete in the HeroesComponent' section.
closes #1603
2016-06-06 17:28:07 -07:00
twinssbc 6f02f76fc2 docs: remove duplicated words in toh-pt6.jade
closes #1575
2016-06-04 01:25:41 -07:00
Anastasia Kozaeva 2f3cb405e8 Fix typo in 'Error Handling' section
closes #1592
Remove duplicate 'to'
2016-06-04 01:24:00 -07:00
Anderson 301aadddde docs(toh-pt6): fix filename typo 2016-06-01 01:19:37 -07:00
Christopher Thorne 2d27097d55 docs(toh-pt6): correct DetailHeroComponent to HeroDetailComponent
closes #1550
2016-05-31 22:32:55 -07:00
Foxandxss 2bc166c34f docs(toh): fix some header extensions
closes #1549
2016-05-29 14:36:10 -07:00
Foxandxss 508b779a41 docs(toh): add instructions to add the goBack method
closes #1478
2016-05-23 12:18:46 -07:00