Commit Graph

283 Commits

Author SHA1 Message Date
Patrice Chalin 5e79a1a2b5 chore: fix broken links and transform API links for dart docs
- Dart non-api doc pages w/ links to API entries will now have those
links translated from a TS API reference URL to a Dart API reference
URL.
- Created and ran a link checker to verify that all such links to API
entries refer to Dart.
- Fixed links to pages that have moved:
 - JS & Dart: `i18n` is under now `cookbook` not `guide`
 - Dart: testing page is now directly under guide.

Contributes to #1895
Fixes #2273
2016-11-07 13:24:20 -08:00
Kathy Walrath e9d40ab2d7 Update most visible AngularDart pages to 2.0 2016-10-26 14:43:53 +02:00
Patrice Chalin b1917b800f chore: remove deprecated liveExample mixins (#2670)
`+liveExample` mixins were replaced by `<live-example>` directives a
while ago. This cleanup fixes link issues to the plunker under ng2.io.
2016-10-25 20:26:13 +01:00
Eric Jimenez 1fe6434b94 chore: rename Developer Guides to Guide in _data.json(#2563) 2016-10-19 21:49:54 +01:00
Kathy Walrath 6e7780dee0 docs(dart/router): link to router tutorial instead of TS router docs (#2529) 2016-10-03 10:52:03 -07:00
Ward Bell 56ac24b411 chore: fix broken links on 9/30, mostly API links (#2520) 2016-10-01 07:11:21 -07:00
Jesús Rodríguez 66e3eca8eb docs(rc4-to-rc5): change cleanup
closes #2516
2016-09-30 17:14:55 -07:00
Ward Bell e6199a8dfb docs(i18n): add internationalization (i18n) guide (#2491)
* docs(i18n): add internationalization (i18n) guide

* docs(cb-i18n): revamped to System.import the translation file
2016-09-29 11:15:55 -07:00
Patrice Chalin 64d5b3dc23 docs(dart): upgrade to beta.22 (#2494)
* update to beta.22
* Dart SDK 1.19.0 or later is required
* minor edits to sample app titles to e2e tests pass
  * Renamed “Angular 2” to “Angular” so that shared e2e tests pass.
* Tweak to QS prose.
2016-09-27 13:41:46 -07:00
Ward Bell 6def9505cc chore: convert templateUrls to use moduleId where possible. (#2477) 2016-09-25 18:51:54 -07:00
Ward Bell b478aaf7a2 docs(testing): from Igor Minar feedback (Part 1) (#2450) 2016-09-23 02:03:20 -07:00
Patrice Chalin 36a3ea2c21 docs(user-input): misc fixes (#2430)
- Remove nonexistent `<important>` “element” since it causes problems
for ng2.io. This is probably a typo. It was more likely meant to be an
anchor name than an element name.
- Fix two PENDING links.
2016-09-21 08:48:38 -07:00
Patrice Chalin 0f99a7c130 docs(cookbook): don't use shredder on intro page (#2418)
Also added missing cookbook AoT chapter placeholders for JS and Dart,
fixing 404s mentioned in #2389.
2016-09-20 10:59:14 -07:00
Jesús Rodríguez 693f6ae462 chore: rename Angular 2 to simply Angular (#2402) 2016-09-19 20:24:40 -07:00
Patrice Chalin 98efced068 docs(lang/latest): parameterize landing page Jade by language (#2389)
ng2.io preparatory work.
2016-09-19 20:14:31 -07:00
Patrice Chalin 0c678c2355 docs: use Jade include rather than Harp partial (#2392)
No net effect on the generated docs.
Preparatory work for ng2.io.
2016-09-19 20:08:03 -07:00
Patrice Chalin e016f3f31e docs(tutorial): don't use shredder for intro page (#2388)
An initial multilang cleanup for ng2.io
2016-09-19 16:56:17 -07:00
Patrice Chalin d26007aa67 docs: fix {ts,dart,js}/latest/_data.json (#2387)
* docs: fix {ts,dart,js}/latest/_data.json

Fixes #2384.
Fixes #2385.

* post-review updates

Addressing #2407.
2016-09-20 00:52:41 +02:00
Alex Wolfe e2ec60d8dd udpate colors and contrast for accessibility improvements 2016-09-16 15:58:20 -07:00
Alex Wolfe 65db6b9268 design(style): Restyle changes from Alex 2016-09-14 17:18:55 -07:00
Ward Bell 1fb488b4ec docs: delete forms- and router-deprecated, jade + examples (#2328) 2016-09-13 18:49:51 -07:00
Ward Bell 01b211193c docs(browser-support): edits (#2299) 2016-09-09 22:21:40 -04:00
Marc Laval d4a641e553 docs(browser-support): document browser support and polyfills (#2244) 2016-09-09 10:02:02 -07:00
Patrice Chalin 562e99463a chore(cheatsheet): fix double banner issue (#2293)
Each page is designed to have a single banner; adjust the cheatsheet to
follow this convention. Also eliminate the article nested within the
`l-conent` div.

Propagated changes/cleanup to JS and Dart.
2016-09-08 15:01:39 -07:00
Patrice Chalin ec076f842e [WIP] chore(dart): update to beta.21 (#2280) 2016-09-07 16:52:04 -07:00
Ward Bell f971685a7c docs(cb-form-validation): ward's tweaks
renamed from cb-validation to cb-form-validation
other refactorings and text changes
2016-08-30 14:53:23 -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
Drew Hintz 5b09914550 chore: better compression of images using zopfli
closes #2196
2016-08-26 10:19:12 -07:00
Ward Bell 8e15829189 docs(ngmodule): fixes for defects discovered by John Papa (#2197)
includes splitting FAQs into its own cookbook.
2016-08-25 19:12:15 -07:00
Patrice Chalin 014883d074 docs(*): fix links to Dart API entries (#2185)
* docs(*): fix links to Dart API entries

* post-review updates
2016-08-24 14:46:06 -07:00
Patrice Chalin fcaf8fa365 docs(forms): add link to Dart sample (#2176)
Contributes to #1598.

Also:
- Trimmed trailing whitespace.
- Fixing user-input (since we don’t need the “Run the” in the link).
2016-08-22 15:41:13 -07:00
Patrice Chalin 9b3614d151 docs(user-input): add link to Dart sample (#2175)
Contributes to #1598.
2016-08-22 15:15:30 -07:00
Patrice Chalin f0daf5d238 docs(lifecycle-hooks): post-RC5 Dart resync (#2141)
* lifecycle-hooks: copy latest to cache

* docs(lifecycle-hooks): post-RC5 Dart resync

- TS prose: removed mention of `routerOnActivate` which no longer
exists in the new router.
- TS improvements to the sample code have also been propagated to the
Dart sample.

Contributes to #2077.
E2E tests pass now.

* post-review updates
2016-08-19 15:07:30 -07:00
Patrice Chalin 0a631087fa docs(dart): upgrade to beta.20 (#2142) 2016-08-18 22:47:52 -07:00
Patrice Chalin 08dec19447 docs(glossary): general cleanup and fix links (#2100)
* glossary: replace cached by latest before edits

* docs(glossary): general cleanup and fix links

This commit addresses issues with the glossary for all languages (JS, TS, Dart).

Fixes #1123, #1838, #2036.

This was originally started as post-RC5 Dart resync, but since mixing Harp partials with Jade mixins can be problematic, this commit does a general cleanup of the 3 x 2 = 6 glossary files (found in `{ts,js,dart}/latest/{.,guide}`).

This commit builds upon #2098 (which created the first `ts/_cache` copy of the glossary), but doesn't really depend on it.

* post-review updates

* post-review updates
2016-08-17 17:50:42 -07:00
Patrice Chalin 0c0c6f69f3 docs(toh-5): TS/Dart review, and Dart resync (#2115)
* 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
2016-08-17 13:31:40 -07:00
Patrice Chalin 68c15c12e5 docs({quickstart,di}): fix code excerpts and titles (#2118) 2016-08-17 09:21:11 -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
Patrice Chalin 2ca6d6567b chore(quickstart/dart): refresh ts _cache (#2089)
Cf. #2088 and #2077.
2016-08-11 11:29:19 -07:00
Patrice Chalin 19d06061c5 docs(quickstart): post-RC5 Dart resync (#2078)
* docs(quickstart): post-RC5 Dart resync

- Resync Dart QS prose with TS, post RC5.
- Added to-be-shared Jade `var` definitions to `_util-fns.jade`.
- Delete cached QS jade file.
- Eliminate the stub file `styles.1.css` in favor of a `docregion` in
the main `styles.css`.

This commit requires a `gulp add-example-boilerplate` after pulling it in.
Contributes to #2077.

* post-review edits
2016-08-10 13:32:07 -07:00
Benjamin Dopplinger c8cc3226cc docs(toh-pt5/dart): remove an already existing line (#2056)
Remove an import statement as the package is already imported at this stage of the tutorial.
2016-08-09 17:17:56 -07:00
Ward Bell aef8aa94aa docs(ngmodule): add chapter 2016-08-09 12:31:52 -07:00
Ward Bell fe35bc6c31 docs(rc4-to-rc5): New RC4->RC5 migration cookbook. 2016-08-09 12:28:25 -07:00
Benjamin Dopplinger ef1171bd36 docs(toh-pt5/dart): fix grammar mistakes (#2057) 2016-08-09 10:43:42 -07:00
Patrice Chalin 5ce8304227 docs(dart): decouple from TS .jade files temporarily (#2044)
Addresses #2043.
2016-08-08 15:48:45 -07:00
Peter Bacon Darwin 35b2dbd867 docs(tutorial): text following a node requires a dot 2016-08-06 07:58:28 +01:00
Brandon Roberts 14ad2a8c68 fix(docs): Renamed files for JavaScript/Dart dynamic form cookbook
closes #2010
2016-08-05 16:57:48 -07:00
Patrice Chalin 531d6a8bce docs(glossary/dart): recover content (#2037)
Fixes #1918.

Follow-up work will be done under #2036.
2016-08-05 12:13:29 -07:00
Patrice Chalin 6a2cad2640 docs(chore): ensure {forms|router}{,-deprecated} chapters have proper content (#2034)
Fixes #2026.
2016-08-05 11:13:32 -07:00
Kathy Walrath a423724847 docs(dart): update angular.io/dart's link to change log 2016-08-03 12:29:04 -07:00