Merge pull request #25 from angular/dart-quickstart

Tweaks to Dart quickstart, Dart resources banner

Author: kwalrath

public/docs/dart/latest/_data.json

@@ -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": {

public/docs/dart/latest/quickstart.jade

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