From a9ef061d0e3b16f64bb51c8ac0248cde6f3bec01 Mon Sep 17 00:00:00 2001 From: Kathy Walrath Date: Tue, 7 Apr 2015 17:18:47 -0700 Subject: [PATCH] Tweaks to Dart quickstart, Dart resources banner --- public/docs/dart/latest/_data.json | 2 +- public/docs/dart/latest/quickstart.jade | 53 ++++++++++++++----------- 2 files changed, 30 insertions(+), 25 deletions(-) diff --git a/public/docs/dart/latest/_data.json b/public/docs/dart/latest/_data.json index 625f3be00a..4982e87a15 100644 --- a/public/docs/dart/latest/_data.json +++ b/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 angulardart.org." + "banner": "Angular 2 is currently in Alpha Preview. For AngularDart 1.X resources, visit angulardart.org." }, "api": { diff --git a/public/docs/dart/latest/quickstart.jade b/public/docs/dart/latest/quickstart.jade index 8f826d4bba..4f1c04c69e 100644 --- a/public/docs/dart/latest/quickstart.jade +++ b/public/docs/dart/latest/quickstart.jade @@ -1,8 +1,14 @@ +p. + Angular 2 is currently in Alpha Preview. + We recommend using + Angular for Dart + 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 - download Dart. + download Dart. Then return here. // STEP 1 - Create a project ########################## @@ -37,19 +43,21 @@ p. pre.prettyprint.lang-basic code. > 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 Dart Editor, - right-click web/index.html, + right-click web/index.html, and choose Open in Dartium. + 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 pub serve, - 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 http://localhost:8080 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 Dev channel of Dart from the - Dart - Download Archive. - - p. - Once you have the Dart Dev channel, use pub upgrade - 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 Angular Resources. + To learn more about Dart, go to + dartlang.org.