Skip to content
This repository was archived by the owner on Dec 4, 2017. It is now read-only.

Tweaks to Dart quickstart, Dart resources banner #25

Merged
merged 1 commit into from
Apr 10, 2015
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion public/docs/dart/latest/_data.json
Original file line number Diff line number Diff line change
Expand Up @@ -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": {
Expand Down
53 changes: 29 additions & 24 deletions public/docs/dart/latest/quickstart.jade
Original file line number Diff line number Diff line change
@@ -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 ##########################
Expand Down Expand Up @@ -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 ##########################
Expand Down Expand Up @@ -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!]

Expand All @@ -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>.