Commit Graph

139 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 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
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
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
Jesús Rodríguez 693f6ae462 chore: rename Angular 2 to simply Angular (#2402) 2016-09-19 20:24:40 -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
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
Drew Hintz 5b09914550 chore: better compression of images using zopfli
closes #2196
2016-08-26 10:19:12 -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 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 68c15c12e5 docs({quickstart,di}): fix code excerpts and titles (#2118) 2016-08-17 09:21:11 -07:00
Ward Bell aef8aa94aa docs(ngmodule): add chapter 2016-08-09 12:31:52 -07:00
Patrice Chalin 5ce8304227 docs(dart): decouple from TS .jade files temporarily (#2044)
Addresses #2043.
2016-08-08 15:48:45 -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
Patrice Chalin 98e5d4af77 docs(all): link cleanup - broken and outdated
closes #1841
Fixes all broken links except genuine errors (see #1840), have been
resolved as of 2016-07-06
(https://github.com/angular/angular/commit/2708ce6a17667a2369c83bcf244c9
366b058d4c9).

Fixes #1574
2016-07-11 21:50:07 -07:00
Patrice Chalin 761f857f13 docs(architecture/dart): proofread, updated Dart/TS app and jade
closes #1807
- e2e tests now also cover the tax calculator.
- Dart app updated to match TS (it had no sales tax calculator).
- TS sample source cleanup (e.g. removed many unnecessary `docregions`).
- Prose updated to include @kwalrath's revisions from a while ago, Ward's comments, and
some of my edits as well.

Contributes to #1598 and #1508.
2016-07-11 20:35:06 -07:00
Patrice Chalin fb9edf972e chore: fix "Invalid example" warnings from shred map builder
closes #1832
The shred map (xref) builder was issuing warnings. This fix includes
- Adjustments to the shredder map builder itself so that it
understands, e.g., app-project relative example paths.
- `**/guide/glossary.jade` now (Jade) `includes` the shared parent
`glossary.jade` rather than (Harp) importing (via `partial`). This
fixes `makeExample` path issues in the glossary.
- Adjusted some `makeExample` paths that were ok for site build, but
confused the xref tool.
2016-07-11 20:10:56 -07:00
Patrice Chalin 801ac76da0 docs(guide/displaying-data): proofread (#1819)
* docs(displaying-data/dart): proofread

- Dart prose simplified by removing discussion of "additions to
pubspec.yaml" which are no longer necessary given the current state of
QuickStart.
- E2e suites passed:
  public/docs/_examples/displaying-data/dart
  public/docs/_examples/displaying-data/ts

Contributes to #1598 and #1508.

* docs(displaying-data/ts): proofread

- TS prose updated to include @kwalrath's revisions from a while ago,
with some of my edits as well.
- E2e suites passed:
  public/docs/_examples/displaying-data/dart
  public/docs/_examples/displaying-data/ts

* docs(displaying-data/ts): post-review edits
2016-07-07 14:00:19 -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
Naomi Black 8548d3cb06 chore(nav): update left nav to add glossary back 2016-06-28 13:58:30 -07:00
Martin Probst fb179d9690 docs(security): Add security documentation.
Substantially rewritten, based on original content by Brian Clarkio and
Ward Bell and contributions from Naomi Black.
2016-06-21 10:51:25 -07:00
Patrice Chalin 3c77a7fcd1 docs(basics/di): minor edits following TS switch to provider object literal (#1600)
Minor edits:
- Dart side adjustments following #1594.
- Renamed example '3a' to just '3' and tweaked the logger message
- Removed obsolete Dart block.
2016-06-08 09:25:48 -07:00
Foxandxss c185c3548c chore: use the provide object literal
closes #1594
replace `provide(...{use:...})` with `{provide: ..., use...}` syntax
2016-06-04 01:33:36 -07:00
Patrice Chalin 05864c2584 docs(dependency-injection): revised Dart and TS code and prose (#1573)
docs(dependency-injection): revise Dart and TS code and prose
2016-06-03 11:16:46 -07:00
Patrice Chalin b48cde3a43 chore(_util-fns): generalize makeExample, drop makeProjExample (#1510)
+ Rename adjustExample{Path|Title} to adjustTsExample*4Dart
+ `makeExample` can now work with both doc folder relative and project
relative paths.
2016-06-02 17:06:03 +01:00
Foxandxss b962383193 chore: re-title webpack guide to emphasize "Webpack", not "Intro"
closes #1492
2016-05-29 12:27:44 -07:00
Patrice Chalin a664f46231 docs(template-syntax): review and update Dart to new doc design (#1465)
* ts template-syntax.jade without docregion tags
* update guide/template-syntax for dart and ts
* clarify style property naming in Dart
2016-05-25 15:09:45 -07:00
Patrice Chalin da48db3c77 docs(server-communication): cleanup, mainly for Dart (#1455)
- Dart code: fix issues raised by @thso during review.
- Dart code: remove "show x" clauses from imports.
- Dart add docsync config file.
- Prose: make consistent use of _Http variables; otherwise use "HTTP".
- Prose: add links to the demos list.

* _heroesUrl as static const
2016-05-20 17:14:37 -07:00
Ward Bell 29511831cd docs(server-communication): heavily refactored (TS & Dart) 2016-05-19 02:48:43 -07:00
Kathy Walrath a595eb81ef docs(dart): update BASICS intro (#1410)
Also copy edited the TS version a bit.
2016-05-18 13:43:02 -07:00
Patrice Chalin ad95b04e69 docs(dev guide): pipes - new Dart prose, update Dart and Ts code (#1353)
+ guide/pipes/ts: update docs and example code

+ guide/pipes/dart: new prose, updated example code

+ fix platform_directives reference; html cleanup

+ enable pipes e2e testing
For `e2e-spec.js`: If the async test is executed too early it will fail
(simply because the async message hasn’t been received yet).

+ follow new constants naming convention
2016-05-13 21:44:14 +01:00
Patrice Chalin c1440e7eff [review-pending] docs(dev guide): server-communication - new prose
New Dart prose, update Dart and Ts code

+ guide/server-communication/ts: update to docs and example code
+ guide/server-communication/dart: new prose, update example code
+ ignore all npm-debug.logs
+ make Jade ul li TOC elements more compact.
2016-05-13 21:32:54 +01:00
Foxandxss 96238bbfab docs(cb-webpack): add guide chapter about webpack 2016-05-12 17:22:14 -07:00
Ward Bell 19bf5f6689 docs(router-deprecated): fix example links that weren't to deprecated code
closes #1340
2016-05-10 21:40:09 -07:00
Patrice Chalin ef66e38e54 docs(dev guide): Update 'Component Styles' prose (#1320)
Reowork Ts prose and add Dart prose/code

+ Updates to docs and example code

(Starting point for Dart code was taken from #1171.)
2016-05-10 08:51:23 +01:00
Patrice Chalin f30d71a3cc docs(dev guide): cleanup of deprecated Jade mixin (#1322)
Replace uses of `liveExLinks` mixin and then deleted its definition.
2016-05-09 21:13:50 +01:00
Patrice Chalin e958be24bf docs(dev guide): attribute-directives - updated dart/ts code and new dart prose
Mainly copyedits and prep for extension

+ example code cleanup & bug fix
+ fix bug in default color initialization
2016-05-06 15:42:01 +01:00
Patrice Chalin ac92e77611 docs(dev guide): lifecycle-hooks - updated dart/ts code and new dart prose
Mainly copyedits, but also

- Dart .jade extends TS .jade file with minor overrides
- Significant update of example code (so it matches the ts example in its
appearance and behavior).
- Tweaks to Dart code.
- A few extra/corrected mixin definitions in `_util-fns.jade`.
2016-05-06 14:17:34 +01:00
Patrice Chalin ce6c645501 docs(dev guide): structural-directives - ts minor edits, dart first versiondocs(dev guide): structural-directives - ts minor edits, dart first version (#1277)
Copyedits and other minor edits for TS
+ first version of the chapter for Dart
2016-05-04 13:18:38 +01:00
Ward Bell 2ccdd867d2 docs(router): samples and doc for new router (phase 1) 2016-05-03 09:18:18 -06:00