Commit Graph

283 Commits

Author SHA1 Message Date
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 eafd7db119 chore(ng2/dart): update from beta.1x to beta.18 (#1941)
* chore(ng2/dart): update from beta.1x to beta.18

Update made to all `pubspec.yaml` files and to relevant prose.
Note that pipes was back a beta.15; the rest were at beta.17.

* chore(pipes/dart): update ngFor microsyntax and transform method param

Updates to pipe example source code:
- Pipe `transform()` method parameters
- `ngFor` microsyntax, from `#` to `let`
2016-07-20 15:51:23 -07: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
Patrice Chalin 753452650c docs(cheatsheet/dart): generate from dart sources (#1912)
* docs(cheatsheet/dart): generate from dart sources

Fixes #1906.
2016-07-19 12:35:39 -07:00
Patrice Chalin 1bef20abc4 docs(api/dart): add support for generation and display (#1888)
Fixes #1880.
Supersedes #1593.
2016-07-15 14:10:12 -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 ff718f4211 docs(cheatsheet/dart): alert reader of possible inaccuracies (#1814)
Until we can generate the cheat sheet properly, at least alert reader
of possible inaccuracies.
2016-07-07 11:42:04 -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
Patrice Chalin 0ba3d5d8d6 docs(dart/{quickstart,toh-[56]}): fix project names (#1773)
- Renamed `angular2_getting_started` to `angular2_quickstart` (to match
TS).
- s/-/_/g in project names elsewhere (only toh-5 & -6 needed to be
updated).

Fixes #378.
2016-07-01 11:05:45 -07:00
Naomi Black 8548d3cb06 chore(nav): update left nav to add glossary back 2016-06-28 13:58:30 -07:00
Patrice Chalin f06398cd89 docs(toh-6/dart): first edition of prose and example code (#1687)
* docs(toh-6/dart): first edition of prose and example code

NOTE: this PR depends on #1686.

Dart prose and example match TS except that:
- No child-to-parent event emission occurs.
- Support for Add Hero is added as an unconditional feature of the
Heroes view.
- http `_post` takes only a name
- http `delete` takes only a hero id.
- The Dart in-memory-data-service has been dropped in favor of an
implementation based on the "standard" `http.testing.MockClient` class.

* post-review changes
2016-06-28 13:12:49 -07:00
Naomi Black 7d5614ef82 chore(version): bump the docs version to rc3 2016-06-22 15:07:34 -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
Kathy Walrath 511ee3d8ed [WIP] Add link to AngularDart API docs 2016-06-16 13:37:44 -07:00
Naomi Black a35e0fd4ef chore(docs): bump version to RC on boilerplate 2016-06-15 16:14:50 -07:00
Patrice Chalin 25dc59daac docs(toh-3/dart): copyedits (#1637) 2016-06-15 14:58:05 -07:00
Patrice Chalin cd970c21ad docs(toh-3/dart): copyedits and new snake_case glossary entry (#1629) 2016-06-15 10:49:42 -07:00
Patrice Chalin 6e5d8e6491 docs(toh-5/dart): review edits and code cleanup (#1643) 2016-06-15 07:46:26 -07:00
Deborah Kurata e7f3fc61ce docs(cb-vs2015) new cookbook for Visual Studio 2015 QuickStart
closes #1502
2016-06-13 23:55:14 -07:00
Patrice Chalin 1cc5284cc2 docs(toh-2/dart): copyedits (#1621) 2016-06-08 16:24:56 -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
Patrice Chalin 7e52648ee7 docs(toh): update live example links (#1602) 2016-06-07 15:51:25 -07:00
Patrice Chalin afee8dbe7e docs(toh-1/dart): minor edits (#1614)
- Fixed HTML.
- Removed unnecessary snippet since it is in the code.
- Copyedit (Hero Property) -> (Hero property).
2016-06-07 14:59:41 -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 7570dc53ea chore(dart/api): remove generated files (#1587) 2016-06-02 10:44:51 -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
Vikash 8569479423 docs: fix numerous typos in many doc files.
closes #1509
2016-06-01 01:08:56 -07:00
Ward Bell 2f115a3425 chore: fix broken devguide links as of May 31
Did not fix broken Dart and API links
2016-06-01 00:52:22 -07:00
Patrice Chalin 5e50b2ef10 chore(util-fns): minor cleanup and refactoring (#1562)
This only impacts language dependent variable and path definitions:
- Removed deprecated variable.
- Hoisted useful variable definitions from quickstart into _util-fns.
- Minor fix in regexp of path translation function
2016-05-31 15:25:59 -07: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 ed16d82335 chore(dart/_util-fns): make adjustTsExamplePath4Dart idempotent (#1515)
Fixes #1513.
2016-05-25 11:43:06 -07:00
Ward Bell f9fea00824 docs(component-relative-paths): new cookbook 2016-05-20 20:33:38 -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
Patrice Chalin 6d2d52c588 docs(dart): cleanup 'live example' links (#1449)
This fixes various issues such as:
- missing space in Dart version between the live demo and demo source
links.
- Live example link directing to Plunker for Dart.

The main mixins (`liveExampleLink`*) used to support the generation of
links now assume reasonable default values for their arguments, and in
most cases the defaults are used.

* Dart example links: use http vs https

As agree to with @kwalrath.
2016-05-20 16:18:58 -07:00
Kathy Walrath 2dc60188c2 docs(dart): convert toh-5 to Dart (#1426)
Some issues remain (see #1426 review comments), but this is much better than nothing.
2016-05-19 08:03:23 -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
Kathy Walrath 2810218b88 docs(quickstart): edit Dart & TS QuickStarts
closes #1411
2016-05-17 14:17:43 -07:00
Eric Jimenez 0ae7ade9fa feat(shorter lines): encapsulate all doc guides within a 10 sized column, including banners. Use showcase. Adjust for mobile 2016-05-16 15:40:32 -04:00
Patrice Chalin fedc39dd52 docs(quickstart-ts/dart): updated prose and example code; consolidate for TS&Dart
closes #1396
2016-05-15 19:26:45 -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
Foxandxss 3f50248940 docs(style-guide): revisions for New World (repack)
closes #1260
2016-05-03 00:42:02 -06:00
Ward Bell 3d5302adce chore: update to rc.0 2016-05-02 19:57:28 -07:00
Eric Jimenez 5ce56598f5 feat(docs landing): new docs landing 2016-05-02 19:55:59 -07:00
Patrice Chalin ff20b55975 chore(dart & ts): update to beta.17
Change `ngFor=“#…”` to `ngFor=“let…` in code. All are .dart files
except for `app_component.html` which also has changes for:
- `<inpuf var-foo…`> to `<input ref-foo…>`
- `#docregion` tag name updates from var-foo to ref-foo.
- Other misc updates to minimize diffs with TS version of file,
whitespace differences were ignored.

+ Minor update to sync up Dart prose with TS prose.

+ Used
https://github.com/angular/angular/wiki/Angular-2-Dart-Transformer#resol
ved_identifiers to solve
https://github.com/angular/angular.io/issues/1033

Guide/pipes not updated as it will be rolled back to
beta.15 in PR #1220.
2016-04-30 15:01:16 +01:00
Patrice Chalin 1e64d9e57a docs(guide/dart): hierarchical-dependency-injection without copying
closes #1207
This uses a simpler way to render Dart prose from TS prose without
making a copy. This will make it _much_ easier to keep the two in sync.
2016-04-28 17:03:28 -07:00
Patrice Chalin 0557c728d7 chore(dart): updating to beta.16
closes #1192

Updated docs and samples to beta.16.

For this first time, among other things, I payed particular attention
to the changes that were made on the `ts` side of things
(https://github.com/angular/angular.io/pull/1178). Since I wrote it up
in my notes, here is the check list of `ts` updates with notes about
how there might be corresponding changes on the Dart side:

- public/docs/_examples/cb-dependency-injection/ts/app/main.ts
- public/docs/_examples/cb-ts-to-js/ts/app/main.ts
  - cb not in Dart docs yet.
- public/docs/_examples/dependency-injection/ts/app/car/car-injector.ts
-
public/docs/_examples/dependency-injection/ts/app/injector.component.ts
  - Updated Dart example code to avoid null argument.
- public/docs/_examples/homepage-hello-world/ts/index.1.html
- public/docs/_examples/homepage-tabs/ts/index.1.html
- public/docs/_examples/homepage-todo/ts/index.1.html
- public/docs/_examples/package.json
  - N/A for Dart.
- public/docs/_examples/pipes/ts/app/app.component.html
- public/docs/_examples/pipes/ts/app/app.component.ts
- public/docs/_examples/pipes/ts/app/exponential-strength.pipe.ts
- public/docs/_examples/pipes/ts/app/fetch-json.pipe.ts
- public/docs/_examples/pipes/ts/app/random-pipe.component.ts
  - Dart version of sample code is incomplete, but did run in beta.15.
  - Example no longer runs, see
https://github.com/angular/angular/issues/8258
- public/docs/_examples/quickstart/js/package.1.json
- public/docs/_examples/quickstart/ts/package.1.json
- public/docs/_examples/router/ts/app/main.2.ts
- public/docs/_examples/testing/ts/app/mock-router.ts
  - N/A for Dart.
- public/docs/js/latest/_data.json
- public/docs/ts/latest/_data.json
  - Dart equivalent updated.
- public/docs/ts/latest/guide/dependency-injection.jade
  - No need to update since it imports the TS version.
- public/docs/ts/latest/guide/pipes.jade
  - Not in Dart prose yet.
- tools/plunker-builder/indexHtmlTranslator.js
  - N/A for Dart.
2016-04-28 15:32:16 -07:00
Eric Jimenez 8f158f2241 docs(sidenav reorg): remove glossary and cheatsheet from REFERENCE. Move glossary to BASICS. Rename REFERENCE to API REFERENCE 2016-04-25 14:10:57 -07:00
Kathy Walrath 7a0d2f6956 docs(dart): proposed text for linking to Dart samples
This PR uses hierarchical-dependency-injection as the guinea pig. The text is similar to what's used in copyedited TS pages such as https://angular.io/docs/ts/latest/guide/displaying-data.html.
2016-04-25 02:48:08 -07:00
Ben Nadel c9d405062d docs(cb-set-document-title): new "Set Title" cookbook chapter
closes #1069
2016-04-23 14:56:56 -07:00
Foxandxss 4097c67b59 chore: rename Elvis to safe navigation operator
closes #1139
2016-04-23 14:22:57 -07:00
Patrice Chalin 9ec291d63d docs(guide/dart): hierarchical-dependency-injection
* A full first version of the prose. Makes use of Dart example, of
course.
* Tweaks to Dart example code; manually tested in Dartium under checked
mode.

closes #1142
2016-04-22 16:56:27 -07:00
Naomi Black 6d13db472a chore(links): make links to API docs relative 2016-04-19 17:44:38 -07:00
Kathy Walrath 3547e4cc15 docs(toh/dart): convert toh-4 to Dart
closes #1091
2016-04-14 16:28:28 -07:00
Kathy Walrath e552239148 chore(dart): update docs/samples to beta.15
closes #1085
2016-04-14 09:26:41 -07:00
Ward Bell f2f5d9f9ae docs(ts): update to beta.15
also restore accidentally deleted router sample files
2016-04-13 19:26:48 -07:00
John Papa bd079369f3 docs(style-guide): add A2 styleguide - v1 2016-04-12 20:08:09 -07:00
Kathy Walrath 1cdd1e681c docs(toh/dart): a few small tweaks
closes #1080
2016-04-12 17:37:03 -07:00
Alberto Jiménez López 8e7c552452 docs: Remove double 'the' & missing dashes in several files
closes #1073
2016-04-11 21:53:28 -07:00
Kathy Walrath adb4093af7 docs(dart): convert toh-3 to Dart
closes #1071
2016-04-11 09:52:52 -07:00
Kathy Walrath cac5c8977f docs(toh/dart): convert toh-2 to dart (#1065) 2016-04-08 15:10:37 -07:00
Kathy Walrath a678d572ce docs(dart/toh): add intro & toh-1 pages (#1063) 2016-04-07 21:11:13 -07:00
Kathy Walrath 8bc3d2e9e5 chore: update dart to b.14
Downrated server-communication to b6; it stopped working in b.9 (or possibly b.8 or b.7).

Closes #1059
2016-04-07 14:19:31 -07:00
Filipe Silva 0ef63166f8 chore: update to beta.14 2016-04-07 21:31:40 +01:00
Tero Parviainen 6f945b7c38 docs(component-styles): add chapter about styling components
closes #1047
2016-04-06 10:02:23 -07:00
Torgeir Helgevold c1f2c397ff docs: add DI cookbook 2016-04-05 10:15:18 -07:00
Kathy Walrath ed4e450497 chore(typo): quide -> guide in cheatsheets
closes #1039
2016-04-01 15:50:09 -07:00
Kathy Walrath a0a2ee6a93 docs(dart): update to beta.13.1
closes #1032
2016-03-31 16:06:24 -07:00
Kathy Walrath 2e3af5c55a docs(dart/quickstart): merge 2 examples into 1
closes #1031
2016-03-31 15:00:24 -07:00
Ward Bell 082932a210 docs: update to beta.13 2016-03-31 13:22:46 -07:00
Kathy Walrath 24a50a91a6 docs(dart): tweak homepage banner
closes #1016
2016-03-30 10:50:22 -07:00
Kathy Walrath 2144b8e5b6 docs(dart): change imports from bootstrap.dart to platform/browser.dart
closes #1013
2016-03-28 14:56:22 -07:00
Tero Parviainen 7f11a6ce05 docs(cb-ts-to-js): add cookbook about applying TypeScript examples to ES5
closes #893
2016-03-27 23:36:51 -07:00
Kathy Walrath 185f9a7049 docs(dart): update to b12
Also update dart_to_js_script_rewriter dependency to ^1.0.1,
and change most angular2.dart imports to be core.dart instead.

The pipes example broke without the angular2.dart import, so I let it be.

The server-communication sample has never worked for me,
so I changed it but might have broken it further.

closes #1007
2016-03-25 17:40:23 -07:00
Kathy Walrath 10877bdbfc docs(dependency-injection): add Dart version, tweak TS version
closes #972
2016-03-25 15:21:11 -07:00
Kathy Walrath b2ae14b2e9 docs(dart): b10 -> b11
closes #986
2016-03-18 16:15:46 -07:00
Kathy Walrath 051c4603a4 docs(dart): update b9 -> b10 in all samples and quickstart
closes #979
2016-03-17 17:16:24 -07:00
Naomi Black 0e8d7afc08 chore(links): fix broken links in dev guides 2016-03-16 20:05:16 -07:00
Luis Vargas a48b307aed docs(toh/dart): add toh-5 sample files and link to them
closes #971
2016-03-16 19:56:56 -07:00
Ward Bell 1a154daa2e chore: add gulp link-checker task
also fix some of the broken links that it found
2016-03-10 23:53:43 -08:00
Kathy Walrath 469612f50c docs(dart): update Dart examples to beta.9
closes #952
2016-03-10 19:05:42 -08:00
Ward Bell 1a8a2d7d90 docs(api): fix api nav issue #927
closes #932
2016-03-08 10:46:03 -08:00
Ward Bell b0f1f3a4b8 docs: simplify left nav selection/scroll
also added some blog posts to resources
2016-03-04 23:54:44 -08:00
Ward Bell bf3ed182a7 docs: left nav is driven by _data.json files 2016-03-04 19:54:27 -08:00
Ward Bell ed5effa503 docs: only allow 'Next Step' for *nextable* chapters 2016-03-03 17:59:36 -08:00
Kathy Walrath cab0abdb2c docs: tweaks and fixes to dart/ts/js navigation & page titles
closes #911
2016-03-03 16:46:28 -08:00