Tweaks to Dart quickstart, Dart resources banner

This commit is contained in:
Kathy Walrath 2015-04-07 17:18:47 -07:00
parent 8c8f148131
commit a9ef061d0e
2 changed files with 30 additions and 25 deletions

View File

@ -14,7 +14,7 @@
"resources": {
"icon": "play-circle-fill",
"title": "Angular Resources",
"banner": "Angular 2 is currently in Alpha Preview. For AngularDart 1.X please visit <a href='https://angulardart.org/'>angulardart.org</a>."
"banner": "Angular 2 is currently in Alpha Preview. For AngularDart 1.X resources, visit <a href='https://angulardart.org/'>angulardart.org</a>."
},
"api": {

View File

@ -1,8 +1,14 @@
p.
<strong>Angular 2 is currently in Alpha Preview.</strong>
We recommend using
<a href='https://angulardart.org'>Angular for Dart</a>
for production applications.
p.
These instructions assume that you already have the Dart SDK
and any tools you like to use with Dart.
If not, go
<a href="https://www.dartlang.org/tools/download.html">download Dart</a>.
<a href="https://www.dartlang.org/downloads/">download Dart</a>.
Then return here.
// STEP 1 - Create a project ##########################
@ -37,19 +43,21 @@ p.
pre.prettyprint.lang-basic
code.
&gt; pub get
Resolving dependencies... (7.3s)
+ angular2 2.0.0-alpha.6
+ browser 0.10.0+2
+ path 1.3.3
+ stack_trace 1.2.3
Changed 4 dependencies!
Resolving dependencies... (2.7s)
+ analyzer 0.24.1 (0.25.0-dev.3 available)
... more messages ...
Changed 21 dependencies!
Precompiling dependencies...
Loading source assets...
Precompiled dart_style.
// PENDING: Create template? Link to pub/pubspec docs?
// Is browser really needed?
.alert.is-helpful.
Depending on your version of Dart, your version numbers (of angular2
and other packages) might be higher than shown above. That's fine.
Depending on your version of Dart and the latest version of angular2,
your messages are probably going to be different from what's shown above.
That's fine.
// STEP 2 - Import Angular ##########################
@ -228,16 +236,20 @@ p.
You have several options for running your app.
The quickest and easiest, for now,
is to open your project in <b>Dart Editor</b>,
right-click <code>web/index.html</code>,
right-click <b>web/index.html</b>,
and choose <b>Open in Dartium</b>.
This starts a web server
and opens your app in an experimental browser that contains the Dart VM.
// TODO: screenshot? embedded app?
p.
Another option is to build and serve the app using <code>pub serve</code>,
and then run it by visiting http://localhost:8080/index.html in a browser.
The JavaScript generated using this option is large, for now;
it'll be much better soon, when Angular's transformer becomes available.
and then run it by visiting <b>http://localhost:8080</b> in a browser.
Generating the JavaScript takes a few seconds when you first visit the page,
and the generated JavaScript is currently large.
The generated JavaScript will be smaller once
Angular's transformer becomes available.
// [PENDING: Update when transformer is working!]
@ -246,14 +258,7 @@ p.
h2#section-transpile Great job! Next step...
p.
To try out the latest Angular 2 APIs,
first download the <b>Dev channel</b> of Dart from the
<a href="https://www.dartlang.org/tools/download-archive/">Dart
Download Archive</a>.
p.
Once you have the Dart Dev channel, use <b>pub upgrade</b>
to get the latest version of Angular 2.
// [PENDING: Perhaps point to dartlang.org.]
We plan to add a developer guide soon.
Until then, check out <a href="resources.html">Angular Resources</a>.
To learn more about Dart, go to
<a href="https://www.dartlang.org">dartlang.org</a>.