From 23fcb95fecc4781ad2e1f43f0bd26e1ad91f2d33 Mon Sep 17 00:00:00 2001
From: Kathy Walrath <kathyw@google.com>
Date: Wed, 3 Jun 2015 12:54:59 -0700
Subject: [PATCH 1/5] Update all the code and text to latest alpha.25 examples

---
 .../dart/latest/guide/displaying-data.jade    | 384 ++++++++++--------
 .../dart/latest/guide/making-components.jade  |  33 +-
 public/docs/dart/latest/guide/setup.jade      |  36 +-
 public/docs/dart/latest/guide/user-input.jade | 108 ++---
 4 files changed, 287 insertions(+), 274 deletions(-)

diff --git a/public/docs/dart/latest/guide/displaying-data.jade b/public/docs/dart/latest/guide/displaying-data.jade
index 7253cd00ff..961d34ad80 100644
--- a/public/docs/dart/latest/guide/displaying-data.jade
+++ b/public/docs/dart/latest/guide/displaying-data.jade
@@ -17,22 +17,19 @@
     a <code>pubspec.yaml</code> file:
 
   code-tabs
-    code-pane(language="dart" name="main.dart" format="linenums").
-      // web/main.dart
-      library displaying_data;
-
+    code-pane(language="dart" name="web/main.dart" format="linenums").
       import 'package:angular2/angular2.dart';
       import 'package:angular2/src/reflection/reflection.dart' show reflector;
-      import 'package:angular2/src/reflection/reflection_capabilities.dart' show ReflectionCapabilities;
+      import 'package:angular2/src/reflection/reflection_capabilities.dart'
+          show ReflectionCapabilities;
 
-      part 'show_properties.dart';
+      import 'package:displaying_data/show_properties.dart';
 
       main() {
         reflector.reflectionCapabilities = new ReflectionCapabilities();
         bootstrap(DisplayComponent);
       }
-    code-pane(language="html" name="index.html" format="linenums").
-      &lt;!-- web/index.html --&gt;
+    code-pane(language="html" name="web/index.html" format="linenums").
       &lt;!DOCTYPE html&gt;
       &lt;html&gt;
         &lt;head&gt;
@@ -47,45 +44,45 @@
         &lt;/body&gt;
       &lt;/html&gt;
     code-pane(language="yaml" name="pubspec.yaml" format="linenums").
-      # pubspec.yaml
       name: displaying_data
       description: Dart version of Angular 2 example, Displaying Data
       version: 0.0.1
       dependencies:
-        angular2: 2.0.0-alpha.23
-        browser: any
+        angular2: 2.0.0-alpha.25
+        browser: ^0.10.0
+      transformers:
+      - angular2:
+          entry_points: web/main.dart
   p.
    All of this code should look familiar from the previous page,
-   except for the <code>library</code> and <code>part</code> statements
+   except for the import of <code>show_properties.dart</code>
    in <code>main.dart</code>.
-   Those statements let you implement part of the app in a different Dart file.
+   That import statement lets you implement part of the app in a different Dart file.
    All three of these files remain similar in the rest of the examples,
-   so we'll just focus on what's different.
+   so we'll focus on what changes.
 
 .l-main-section
   h2#section-showing-properties-with-interpolation Showing properties with interpolation
   p.
     The simple method for binding text into templates is through interpolation,
     where you put the name of a property
-    inside <strong>{{ }}</strong>.
+    inside <strong ng-non-bindable="">{{ }}</strong>.
 
   p.
-    To see this working, create a Dart file under <code>web</code>
-    named <code>show_properties.dart</code>,
-    and add the following:
+    To see this working, first create a <code>lib</code> directory.
+    Under it, put a Dart file named <code>show_properties.dart</code>
+    that contains the following code:
 
-  code-example(language="dart" format="linenums").
+  code-example(language="dart" format="linenums" escape="html").
     // web/show_properties.dart
-    part of displaying_data;
+    library displaying_data.show_properties;
 
-    @Component(
-      selector: 'display'
-    )
-    @View(
-      template: '''
-    &lt;p>My name: {{ myName }}&lt/p>
-    '''
-    )
+    import 'package:angular2/angular2.dart';
+
+    @Component(selector: 'display')
+    @View(template: '''
+    <p>My name: {{ myName }}</p>
+    ''')
     class DisplayComponent {
       String myName = 'Alice';
     }
@@ -94,8 +91,8 @@
     You've just defined a component that encompasses a view and controller for the app. The view
     defines a template:
 
-  code-example(language="html").
-    &lt;p&gt;My name: {{ myName }}&lt;/p&gt;
+  code-example(language="html" escape="html").
+    <p>My name: {{ myName }}</p>
 
   p.
    Angular will automatically pull the value of <code>myName</code> and
@@ -132,85 +129,86 @@
     &lt;p&gt;Current time: {{ time }}&lt;/p&gt;
 
   p.
-    Then give the <code>DisplayComponent</code> a starting value for time and
-    a call to update time
-    via <code>setInterval</code>:
+    Then import <code>dart:async</code> so you can use a Timer,
+    and give the <code>DisplayComponent</code> a starting value for time and
+    create a periodic Timer call to update the time:
 
-  code-example(language="dart" format="linenums").
-      class DisplayComponent {
-        String myName = 'Alice';
-        String time;
-        Timer _timer;
+  code-example(language="dart").
+    import 'dart:async';
+    ...
+    class DisplayComponent {
+      String myName = 'Alice';
+      String time;
+      Timer _timer;
 
-        DisplayComponent() {
-          _updateTime(null);
-          _timer = new Timer.periodic(new Duration(seconds: 1), _updateTime);
-        }
-
-        _updateTime(Timer _) {
-          time = new DateTime.now().toString();
-        }
+      DisplayComponent() {
+        _updateTime(null);
+        _timer = new Timer.periodic(new Duration(seconds: 1), _updateTime);
       }
 
+      _updateTime(Timer _) {
+        time = new DateTime.now().toString();
+      }
+    }
+
   p Reload the app, and you'll now see the seconds updating automatically.
 
 .l-main-section
-  h2#Create-an-array Display an iterable using *for
+  h2#Create-an-array Display an iterable using *ng-for
   p Moving up from a single value, create a property that's a list of values.
 
-  code-example(language="dart" format="linenums").
+  code-example(language="dart").
     class DisplayComponent {
       String myName = 'Alice';
-      List&lt;String&gt; friendNames = ['Aarav', 'Martín', 'Shannon', 'Ariana', 'Kai'];
+      List&lt;String> friendNames = const [
+        'Aarav',
+        'Martín',
+        'Shannon',
+        'Ariana',
+        'Kai'
+      ];
     }
 
   p.
-    You can then use this list in your template with the <code>for</code> directive to create copies of DOM elements
+    You can then use this list in your template with
+    the <code>ng-for</code> directive to create copies of DOM elements
     with one for each item in the list.
 
-  code-example(language="dart" format="linenums").
-    @View(
-      template: '''
-    &lt;p>My name: {{ myName }}&lt;/p>
-    &lt;p>Friends:&lt;/p>
-    &lt;ul>
-       &lt;li *for="#name of friendNames">
+  code-example(language="dart").
+    @View(template: '''
+    &lt;p&gt;My name: {{ myName }}&lt;/p&gt;
+    &lt;p&gt;Friends:&lt;/p&gt;
+    &lt;ul&gt;
+       &lt;li <span class="pnk">*ng-for="#name of friendNames"</span>&gt;
           {{ name }}
-       &lt;/li>
-    &lt;/ul>
-      '''
-      )
-  p.
-    To make this work, you'll also need to add the Angular <code>For</code> directive used by
-    the template to <code>show_properties.dart</code>, so that Angular knows to include it.
-    Add <code>For</code> using the optional <code>directives</code> parameter,
-    which contains a list of directives:
+       &lt;/li&gt;
+    &lt;/ul&gt;
+    ''', <span class="pnk">directives: const [NgFor]</span>)
 
-  code-example(language="dart" format="linenums").
-    @View(
-      template: '''
-    // ...HTML...
-      ''',
-      directives: const[For]
-    )
+  p.
+    To make <code>ng-for</code> work,
+    you need to add the Angular <code>NgFor</code> directive,
+    so that Angular knows to include it.
+    Add <code>NgFor</code> using the optional <code>directives</code> parameter.
 
   p Reload and you've got your list of friends!
   p.
-    Again, Angular will mirror changes you make to this list over in the DOM. Add a new item and it appears in your
-    list. Delete one and Angular deletes the &lt;li&gt;. Reorder items and Angular makes the corresponding reorder of
-    the DOM list.
+    Again, Angular will mirror changes you make to this list over in the DOM.
+    Add a new item and it appears in your list.
+    Delete one and Angular deletes the &lt;li&gt;.
+    Reorder items and Angular makes the corresponding reorder of the DOM list.
 
   p Let's look at the few lines that do the work again:
 
-  code-example(language="html" format="linenums").
-    &lt;li *for=&quot;#name of friendNames&quot;&gt;
+  code-example(language="html").
+    &lt;li *ng-for=&quot;#name of friendNames&quot;&gt;
        {{ name }}
     &lt;/li&gt;
 
   p The way to read this is:
   ul
     li.
-      <code>*for</code>: Create a DOM element for each item in an
+      <code>*ng-for</code>: Create a DOM element for each item in an
       <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols">iterable</a>
        such as a list.
     li <code>#name</code>: Refer to individual values of the iterable as <code>name</code>.
@@ -221,157 +219,151 @@
 .l-main-section
   h2#Create-a-class Create a model and inject it
   p.
-    Before we get too much further, we should mention that putting the model (list) directly into the controller isn't
-    proper form.  We should separate the concerns by having another class serve the role of model and inject it into
-    the controller.
+    Before we get too much further, we should mention that
+    putting the model (list) directly into the controller isn't proper form.
+    We should separate the concerns by having another class
+    serve the role of model and inject it into the controller.
 
   p.
-    Make a <code>FriendsService</code> class to implement a model containing a list of friends. We'll put this in a new
-    <code>friends_service.dart</code> under <code>web/</code>. Here's what the class looks like:
+    Make a <code>FriendsService</code> class to implement a model
+    containing a list of friends.
+    Put this in a new file under <code>web/</code>
+    named <code>friends_service.dart</code>. Here's what the class looks like:
 
   code-example(language="dart" format="linenums").
     // web/friends_service.dart
-    part of displaying_data;
+    library displaying_data.friends_service;
 
+    import 'package:angular2/angular2.dart';
+
+    @Injectable()
     class FriendsService {
-      List&lt;String&gt; friendNames = ['Aarav', 'Martín', 'Shannon', 'Ariana', 'Kai'];
+      List&lt;String> names = ['Aarav', 'Martín', 'Shannon', 'Ariana', 'Kai'];
     }
 
-  .callout.is-helpful
-    header Note
-    p.
-      Remember to tie <code>friends_service.dart</code> into the library's main file:
-      add <code>part friends_service.dart</code> to <code>main.dart</code>.
   p.
     Now you can replace the current list of friends in DisplayComponent.
-    First add a FriendsService parameter to the constructor.
+    Import <code>friends_service.dart</code>,
+    and add a FriendsService parameter to the constructor.
     Then set <code>friendNames</code> to the names provided by the service.
 
-  code-example(language="dart" format="linenums").
+  code-example(language="dart").
     // In web/show_properties.dart
+    <span class="pnk">import 'package:displaying_data/friends_service.dart';</span>
+    ...
     class DisplayComponent {
       String myName = 'Alice';
-      List<String> friendNames;
+      List&lt;String&gt; friendNames;
 
-      DisplayComponent(FriendsService friendsService) {
-        friendNames = friendsService.names;
+      DisplayComponent(<span class="pnk">FriendsService friendsService</span>) {
+        <span class="pnk">friendNames = friendsService.names;</span>
       }
     }
 
   p.
     Next, make FriendsService available to dependency injection
-    by adding an <code>injectables</code> parameter to DisplayComponent's
+    by adding an <code>appInjector</code> parameter to DisplayComponent's
     <code>@Component</code> annotation:
 
-  code-example(language="dart" format="linenums").
-    @Component(
-      selector: 'display',
-      injectables: const[FriendsService]
-    )
+  code-example(language="dart").
+    @Component(selector: 'display', <span class="pnk">appInjector: const [FriendsService]</span>)
 
 .l-main-section
-  h2#Conditionally-displaying-data-with-If Conditionally display data using *if
+  h2#Conditionally-displaying-data-with-NgIf Conditionally display data using *ng-if
   p.
-    Lastly, before we move on, let's handle showing parts of our UI conditionally with <code>*if</code>.  The
-    <code>If</code> directive adds or removes elements from the DOM based on the expression you provide.
+    Lastly, before we move on, let's handle showing parts of our UI conditionally with <code>*ng-if</code>.  The
+    <code>NgIf</code> directive adds or removes elements from the DOM based on the expression you provide.
 
   p See it in action by adding a paragraph at the end of your template:
 
   code-example(language="html").
-    &lt;p *if=&quot;names.length &gt; 3&quot;&gt;You have many friends!&lt;/p&gt;
+    &lt;p *ng-if="friendNames.length &gt; 3"&gt;You have many friends!&lt;/p&gt;
 
   p.
-    Also add <code>If</code> to the list of directives,
+    Also add <code>NgIf</code> to the list of directives,
     so Angular knows to include it:
 
   code-example(language="dart").
-    directives: const[For, If]
+    directives: const[NgFor, <span class="pnk">NgIf</span>]
   p.
-    The list current has 5 items, so if you run the app you'll see the message
+    The list currently has 5 items, so if you run the app you'll see the message
     congratulating you on your many friends.
     Remove two items from the list, reload your browser,
     and see that the message no longer displays.
-    <!-- PENDING: mention somewhere that once you start a web server,
-    you can just refresh the browser to see your changes. -->
 
   p Here's the final code.
 
   code-tabs
-    code-pane(language="dart" name="show_properties.dart" format="linenums").
-      // web/show_properties.dart
-      part of displaying_data;
+    code-pane(language="dart" name="lib/show_properties.dart" format="linenums").
+      library displaying_data.show_properties;
 
-      @Component(
-        selector: 'display',
-        injectables: const[FriendsService]
-      )
-      @View(
-        template: '''
-      &lt;p>My name: {{ myName }}&lt;/p>
-      &lt;p>Friends:&lt;/p>
-      &lt;ul>
-         &lt;li *for="#name of friendNames">
+      import 'package:angular2/angular2.dart';
+      import 'package:displaying_data/friends_service.dart';
+
+      @Component(selector: 'display', appInjector: const [FriendsService])
+      @View(template: '''
+      &lt;p&gt;My name: {{ myName }}&lt;/p&gt;
+      &lt;p&gt;Friends:&lt;/p&gt;
+      &lt;ul&gt;
+         &lt;li *ng-for="#name of friendNames"&gt;
             {{ name }}
-         &lt;/li>
-      &lt;/ul>
-      ''',
-        directives: const[For]
-      )
+         &lt;/li&gt;
+      &lt;/ul&gt;
+      &lt;p *ng-if="friendNames.length &gt; 3"&gt;You have many friends!&lt;/p&gt;
+      ''', directives: const [NgFor, NgIf])
       class DisplayComponent {
         String myName = 'Alice';
-        List&lt;String> friendNames;
+        List&lt;String&gt; friendNames;
 
         DisplayComponent(FriendsService friendsService) {
           friendNames = friendsService.names;
         }
       }
-    code-pane(language="dart" name="friends_service.dart" format="linenums").
-      // web/friends_service.dart
-      part of displaying_data;
-
-      class FriendsService {
-        List&lt;String> names = ['Aarav', 'Martín', 'Shannon', 'Ariana', 'Kai'];
-      }
-    code-pane(language="dart" name="main.dart" format="linenums").
-      // web/main.dart
-      library displaying_data;
-
-      import 'dart:async';
+    code-pane(language="dart" name="lib/friends_service.dart" format="linenums").
+      library displaying_data.friends_service;
 
       import 'package:angular2/angular2.dart';
-      import 'package:angular2/src/reflection/reflection.dart' show reflector;
-      import 'package:angular2/src/reflection/reflection_capabilities.dart' show ReflectionCapabilities;
 
-      part 'show_properties.dart';
-      part 'friends_service.dart';
+      @Injectable()
+      class FriendsService {
+        List&lt;String&gt; names = ['Aarav', 'Martín', 'Shannon', 'Ariana', 'Kai'];
+      }
+    code-pane(language="dart" name="web/main.dart" format="linenums").
+      import 'package:angular2/angular2.dart';
+      import 'package:angular2/src/reflection/reflection.dart' show reflector;
+      import 'package:angular2/src/reflection/reflection_capabilities.dart'
+          show ReflectionCapabilities;
+
+      import 'package:displaying_data/show_properties.dart';
 
       main() {
         reflector.reflectionCapabilities = new ReflectionCapabilities();
         bootstrap(DisplayComponent);
       }
-    code-pane(language="html" name="index.html" format="linenums").
-      &lt;!-- web/index.html --&gt;
+    code-pane(language="html" name="web/index.html" format="linenums").
       &lt;!DOCTYPE html&gt;
       &lt;html&gt;
         &lt;head&gt;
-          &lt;link rel=&quot;stylesheet&quot; href=&quot;style.css&quot;&gt;
+          &lt;link rel="stylesheet" href="style.css"&gt;
         &lt;/head&gt;
         &lt;body&gt;
 
           &lt;display&gt;&lt;/display&gt;
 
-          &lt;script type=&quot;application/dart&quot; src=&quot;main.dart&quot;&gt;&lt;/script&gt;
-          &lt;script src=&quot;packages/browser/dart.js&quot;&gt;&lt;/script&gt;
+          &lt;script type="application/dart" src="main.dart"&gt;&lt;/script&gt;
+          &lt;script src="packages/browser/dart.js"&gt;&lt;/script&gt;
         &lt;/body&gt;
       &lt;/html&gt;
     code-pane(language="yaml" name="pubspec.yaml" format="linenums").
-      # pubspec.yaml
       name: displaying_data
-      description: Dart version of Angular 2 example, Displaying Data
+      description: Displaying Data example
       version: 0.0.1
       dependencies:
-        angular2: 2.0.0-alpha.23
-        browser: any
+        angular2: 2.0.0-alpha.25
+        browser: ^0.10.0
+      transformers:
+      - angular2:
+          entry_points: web/main.dart
 .l-main-section
   h2#section-explanations Explanations
 
@@ -380,40 +372,74 @@
 
     p.
       Dart offers a few ways to implement an app in multiple files.
-      In this guide, all the code for each example is in a single library;
-      each Dart file under <code>web</code> is part of that library.
+      In this guide, each example is in a single package,
+      and each Dart file implements a separate library.
+      For a bigger project, you might split the code into libraries
+      in two or more packages.
 
     p.
-      To let the code in <code>main.dart</code>
-      use the code in <code>show_properties.dart</code>,
-      declare a library in <code>main.dart</code>.
-      Then make <code>show_properties.dart</code> part of that library.
+      To use the API defined in <code>show_properties.dart</code>,
+      <code>main.dart</code> must import that file.
+      The import statement uses the package name
+      (defined in <code>pubspec.yaml</code> to be <b>displaying_data</b>)
+      and the path to <code>show_properties.dart</code>
+      (starting at the app's top directory,
+      but omitting the <code>lib/</code> directory).
 
-    code-tabs
-      code-pane(language="dart" name="main.dart" format="linenums").
-        // web/main.dart
-        library displaying_data;
-        // imports...
-        part 'show_properties.dart';
-        // Code goes here...
-      code-pane(language="dart" name="show_properties.dar" format="linenums").
-        // web/show_properties.dart
-        part of displaying_data;
-        // Code goes here...
+    code-example(language="dart").
+      // In web/main.dart:
+      ...
+      import 'package:displaying_data/show_properties.dart';
+      ...
+
+      // In lib/show_properties.dart:
+      library displaying_data.show_properties;
+      ...
 
     p.
-      Another way to split Dart code is to
-      define multiple libraries in a single package.
-      The additional libraries go under a <code>lib</code> directory
-      parallel to <code>web</code>.
-      <!-- PENDING: show or point to an example -->
+      The name that <code>show_properties.dart</code> specifies for its library
+      is similar to the path used to import the library,
+      but with no ".dart" suffix and
+      with dots (<code>.</code>) instead of slashes (<code>/</code>).
+      <a href="https://www.dartlang.org/articles/style-guide/#do-name-libraries-and-source-files-using-lowercasewithunderscores">Naming
+      conventions for libraries</a>,
+      along with lots of other helpful information, are in the
+      <a href="https://www.dartlang.org/articles/style-guide/">Dart Style Guide</a>.
 
     p.
-      Yet another approach, often used when some of the code is highly reusable,
-      is to split the code into libraries in two or more packages.
+      Another import lets <code>show_properties.dart</code>
+      use the API defined in <code>friends_service.dart</code>:
+
+    code-example(language="dart").
+      // In lib/show_properties.dart:
+      library displaying_data.show_properties;
+      ...
+      import 'package:displaying_data/friends_service.dart';
+      ...
+
+      // In lib/friends_service.dart:
+      library displaying_data.friends_service;
+      ...
+
+    p.
+      Because both <code>show_properties.dart</code> and <code>friends_service.dart</code>
+      are under <code>lib</code>,
+      the import could instead use a relative path:
+
+    code-example(language="dart").
+      // In lib/show_properties.dart:
+      library displaying_data.show_properties;
+      ...
+      import 'friends_service.dart';
+      ...
+
+      // In lib/friends_service.dart:
+      library displaying_data.friends_service;
+      ...
 
     p.
       For more information on implementing Dart libraries, see
       <a href="https://www.dartlang.org/docs/dart-up-and-running/ch02.html#libraries-and-visibility">Libraries and visibility</a>
       in the
       <a href="https://www.dartlang.org/docs/dart-up-and-running/ch02.html">Dart language tour</a>.
+
diff --git a/public/docs/dart/latest/guide/making-components.jade b/public/docs/dart/latest/guide/making-components.jade
index aacb4a9697..45cb6c4b0b 100644
--- a/public/docs/dart/latest/guide/making-components.jade
+++ b/public/docs/dart/latest/guide/making-components.jade
@@ -11,18 +11,16 @@
     component that uses a <code>&lt;child&gt;</code> component like so:
 
   code-example(language="dart" format="linenums").
-    part of making_components;
+    library parent_child.parent;
 
-    @Component(
-      selector: 'parent'
-    )
-    @View(
-      template: '''
+    import 'package:angular2/angular2.dart';
+    import 'package:parent_child/child.dart';
+
+    @Component(selector: 'parent')
+    @View(template: '''
         &lt;h1&gt;{{ message }}&lt;/h1&gt;
         <span class="pnk">&lt;child&gt;&lt;/child&gt;</span>
-    ''',
-      directives: const[<span class="pnk">ChildComponent</span>]
-    )
+    ''', directives: const [<span class="pnk">ChildComponent]</span>)
     class ParentComponent {
       String message = "I'm the parent";
     }
@@ -30,19 +28,16 @@
   p You then just need to write the <code>ChildComponent</code> class to make it work:
 
   code-example(language="dart" format="linenums").
-    part of making_components;
+    library parent_child.child;
 
-    @Component(
-        selector: 'child'
-    )
-    @View(
-        template: '''
+    import 'package:angular2/angular2.dart';
+
+    @Component(selector: 'child')
+    @View(template: '''
         &lt;p&gt; {{ message }} &lt;/p&gt;
-    '''
-    )
+    ''')
     class ChildComponent {
       String message = "I'm the child";
     }
 
-  //p.
-    [TODO: Motivate communication between components with iterator example that passes index to the child]
+//- [TODO: Motivate communication between components with iterator example that passes index to the child]
diff --git a/public/docs/dart/latest/guide/setup.jade b/public/docs/dart/latest/guide/setup.jade
index 9aeb1fcec3..0fbc0f2d4b 100644
--- a/public/docs/dart/latest/guide/setup.jade
+++ b/public/docs/dart/latest/guide/setup.jade
@@ -27,11 +27,14 @@
   code-example(language="yaml").
     # pubspec.yaml
     name: getting_started
-    description: Dart version of Angular 2 example, Getting Started
+    description: Getting Started example
     version: 0.0.1
     dependencies:
-      angular2: 2.0.0-alpha.23
-      browser: any
+      angular2: 2.0.0-alpha.25
+      browser: ^0.10.0
+    transformers:
+    - angular2:
+        entry_points: web/main.dart
   p.
     Run <b>pub get</b> to download the packages your app depends on.
     (<a href="https://www.dartlang.org/tools/">Dart-savvy editors and IDEs</a>
@@ -50,20 +53,16 @@
     and creating a top-level <code>main()</code> function that calls
     Angular's <code>bootstrap()</code> function.
 
-  code-example(language="javascript").
+  code-example(language="dart" escape="html").
     // web/main.dart
     import 'package:angular2/angular2.dart';
     import 'package:angular2/src/reflection/reflection.dart' show reflector;
-    import 'package:angular2/src/reflection/reflection_capabilities.dart' show ReflectionCapabilities;
+    import 'package:angular2/src/reflection/reflection_capabilities.dart'
+        show ReflectionCapabilities;
 
-    @Component(
-      selector: 'my-app'
-    )
-    @View(
-      template: '&lt;h1&gt;My first Angular 2 App&lt;/h1&gt;'
-    )
-    class AppComponent {
-    }
+    @Component(selector: 'my-app')
+    @View(template: '<h1>My first Angular 2 App</h1>')
+    class AppComponent {}
 
     main() {
       reflector.reflectionCapabilities = new ReflectionCapabilities();
@@ -73,7 +72,8 @@
 .l-main-section
   h2#section-create-an-entry-point Create an HTML file
   p.
-    In the <code>web/</code> directoryapp, create an HTML file (<code>index.html</code>).
+    In the <code>web/</code> directory of your app,
+    create an HTML file (<code>index.html</code>).
     Edit <code>index.html</code> to add a <code>&lt;my-app&gt;</code> element
     and call <code>main.dart</code>.
 
@@ -98,14 +98,6 @@
     Now run the app. How you do this depends on your tools.
 
   ul
-    li.
-      If you're using <b>Dart Editor</b>,
-      right-click <b>web/index.html</b>,
-      and choose <b>Open in Dartium</b>.
-      This starts a web server
-      and opens your app in Dartium,
-      an experimental version of the Chromium browser that contains the Dart VM.
-
     li.
       If you're using <b>WebStorm</b> or <b>IntelliJ IDEA</b>,
       right-click <b>web/index.html</b>,
diff --git a/public/docs/dart/latest/guide/user-input.jade b/public/docs/dart/latest/guide/user-input.jade
index a79bdca809..86d48801b9 100644
--- a/public/docs/dart/latest/guide/user-input.jade
+++ b/public/docs/dart/latest/guide/user-input.jade
@@ -44,11 +44,14 @@
     Then add a method that adds new items
     to the list.
 
-  code-example(language="dart" format="linenums").
+  code-example(language="dart").
     class TodoList {
-      List&lt;String&gt; todos =
-        ['Eat breakfast', 'Walk dog', 'Breathe', 'Learn Angular'];
-
+      List&lt;String&gt; todos =[
+        'Eat breakfast',
+        'Walk dog',
+        'Breathe',
+        'Learn Angular'
+      ];
       addTodo(String todo) {
         todos.add(todo);
       }
@@ -67,12 +70,12 @@
 .l-main-section
   h2#section-display-the-list-of-todos Display the list of todos
   p.
-    Using the <code>*for</code> iterator, create an <code>&lt;li&gt;</code> for each item in the todos list and set
+    Using the <code>*ng-for</code> iterator, create an <code>&lt;li&gt;</code> for each item in the todos list and set
     its text to the value.
 
-  code-example(language="html" format="linenums").
+  code-example(language="html").
     &lt;ul&gt;
-       &lt;li *for=&quot;#todo of todos&quot;&gt;
+       &lt;li *ng-for=&quot;#todo of todos&quot;&gt;
          {{ todo }}
        &lt;/li&gt;
     &lt;/ul&gt;
@@ -101,54 +104,54 @@
     <a href="https://api.dartlang.org/apidocs/channels/stable/dartdoc-viewer/dart:html">dart:html</a>,
     so be sure to import that library.
 
-  code-tabs
-    code-pane(language="dart" name="todo_list.dart" format="linenums").
-      // In the template:
-      &lt;input #todotext (keyup)="doneTyping(\$event)"&gt;
+  code-example(language="dart").
+    import 'dart:html';
+    ...
 
-      // In the component controller class:
-      doneTyping(KeyboardEvent event) {
-        if (event.keyCode == KeyCode.ENTER) {
-          InputElement e = event.target;
-          addTodo(e.value);
-          e.value = null;
-        }
+    // In the template:
+    &lt;input #todotext (keyup)="doneTyping(\$event)"&gt;
+    ...
+
+    // In the component controller class:
+    doneTyping(KeyboardEvent event) {
+      if (event.keyCode == KeyCode.ENTER) {
+        InputElement e = event.target;
+        addTodo(e.value);
+        e.value = null;
       }
-    code-pane(language="dart" name="main.dart" format="linenums").
-      library user_input;
-
-      import 'dart:html';
-      ...
+    }
 
 .l-main-section
   h2#section-final-code Final code
 
   code-tabs
-    code-pane(language="dart" name="todo_list.dart" format="linenums").
-      // web/todo_list.dart
-      part of user_input;
+    code-pane(language="dart" name="lib/todo_list.dart" format="linenums").
+      library user_input.todo_list;
 
-      @Component(
-        selector: 'todo-list'
-      )
+      import 'dart:html';
+      import 'package:angular2/angular2.dart';
+
+      @Component(selector: 'todo-list')
       @View(
-        // Without r before ''' (a raw string), $event breaks Angular.
-        // An alternative to a raw string is to use \$event instead.
-        template: r'''
+          // An alternative to using \$event is to use a raw string instead.
+          // For example, change "template: '''" to "template: r'''".
+          template: '''
           &lt;ul&gt;
-            &lt;li *for=&quot;#todo of todos&quot;&gt;
+            &lt;li *ng-for="#todo of todos"&gt;
               {{ todo }}
             &lt;/li&gt;
           &lt;/ul&gt;
 
-          &lt;input #todotext (keyup)="doneTyping($event)"&gt;
-          &lt;button (click)="addTodo(todotext.value)"&gt;Add Todo&lt;/button&gt;
-         ''',
-           directives: const[For]
-      )
+          &lt;input #todotext (keyup)="doneTyping(\$event)"&gt;
+          &lt;button (click)="addTodo(todotext.value)"&gt;Add Todo&lt;/button>
+      ''', directives: const [NgFor])
       class TodoList {
-        List&lt;String&gt; todos =
-          ['Eat breakfast', 'Walk dog', 'Breathe', 'Learn Angular'];
+        List&lt;String&gt; todos = [
+          'Eat breakfast',
+          'Walk dog',
+          'Breathe',
+          'Learn Angular'
+        ];
 
         addTodo(String todo) {
           todos.add(todo);
@@ -162,24 +165,19 @@
           }
         }
       }
-    code-pane(language="dart" name="main.dart" format="linenums").
-      // web/main.dart
-      library user_input;
-
-      import 'dart:html';
-
+    code-pane(language="dart" name="web/main.dart" format="linenums").
       import 'package:angular2/angular2.dart';
       import 'package:angular2/src/reflection/reflection.dart' show reflector;
-      import 'package:angular2/src/reflection/reflection_capabilities.dart' show ReflectionCapabilities;
+      import 'package:angular2/src/reflection/reflection_capabilities.dart'
+          show ReflectionCapabilities;
 
-      part 'todo_list.dart';
+      import 'package:user_input/todo_list.dart';
 
       main() {
         reflector.reflectionCapabilities = new ReflectionCapabilities();
         bootstrap(TodoList);
       }
-    code-pane(language="html" name="index.html" format="linenums").
-      &lt;!-- web/index.html --&gt;
+    code-pane(language="html" name="web/index.html" format="linenums").
       &lt;!DOCTYPE html&gt;
       &lt;html&gt;
         &lt;head&gt;
@@ -194,10 +192,12 @@
         &lt;/body&gt;
       &lt;/html&gt;
     code-pane(language="yaml" name="pubspec.yaml" format="linenums").
-      # pubspec.yaml
       name: user_input
-      description: Dart version of Angular 2 example, Responding to User Input
+      description: User Input example
       version: 0.0.1
       dependencies:
-        angular2: 2.0.0-alpha.23
-        browser: any
+        angular2: 2.0.0-alpha.25
+        browser: ^0.10.0
+      transformers:
+      - angular2:
+          entry_points: web/main.dart

From 8db6131edeabedd12b941732ba2caab03a291677 Mon Sep 17 00:00:00 2001
From: Kathy Walrath <kathyw@google.com>
Date: Wed, 3 Jun 2015 13:13:20 -0700
Subject: [PATCH 2/5] escape some >s

---
 public/docs/dart/latest/guide/displaying-data.jade | 4 ++--
 public/docs/dart/latest/guide/setup.jade           | 2 +-
 public/docs/dart/latest/guide/user-input.jade      | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/public/docs/dart/latest/guide/displaying-data.jade b/public/docs/dart/latest/guide/displaying-data.jade
index 961d34ad80..648c036e5a 100644
--- a/public/docs/dart/latest/guide/displaying-data.jade
+++ b/public/docs/dart/latest/guide/displaying-data.jade
@@ -160,7 +160,7 @@
   code-example(language="dart").
     class DisplayComponent {
       String myName = 'Alice';
-      List&lt;String> friendNames = const [
+      List&lt;String&gt; friendNames = const [
         'Aarav',
         'Martín',
         'Shannon',
@@ -238,7 +238,7 @@
 
     @Injectable()
     class FriendsService {
-      List&lt;String> names = ['Aarav', 'Martín', 'Shannon', 'Ariana', 'Kai'];
+      List&lt;String&gt; names = ['Aarav', 'Martín', 'Shannon', 'Ariana', 'Kai'];
     }
 
   p.
diff --git a/public/docs/dart/latest/guide/setup.jade b/public/docs/dart/latest/guide/setup.jade
index 0fbc0f2d4b..b0e405e294 100644
--- a/public/docs/dart/latest/guide/setup.jade
+++ b/public/docs/dart/latest/guide/setup.jade
@@ -78,7 +78,7 @@
     and call <code>main.dart</code>.
 
   code-example(language="html").
-    &lt;!-- web/index.html -->
+    &lt;!-- web/index.html --&gt;
     &lt;!DOCTYPE html&gt;
     &lt;html&gt;
       &lt;head&gt;
diff --git a/public/docs/dart/latest/guide/user-input.jade b/public/docs/dart/latest/guide/user-input.jade
index 86d48801b9..f67350caba 100644
--- a/public/docs/dart/latest/guide/user-input.jade
+++ b/public/docs/dart/latest/guide/user-input.jade
@@ -143,7 +143,7 @@
           &lt;/ul&gt;
 
           &lt;input #todotext (keyup)="doneTyping(\$event)"&gt;
-          &lt;button (click)="addTodo(todotext.value)"&gt;Add Todo&lt;/button>
+          &lt;button (click)="addTodo(todotext.value)"&gt;Add Todo&lt;/button&gt;
       ''', directives: const [NgFor])
       class TodoList {
         List&lt;String&gt; todos = [

From e1fdffc887c839d1f543fa80de972f53a22f71ec Mon Sep 17 00:00:00 2001
From: Kathy Walrath <kathyw@google.com>
Date: Fri, 5 Jun 2015 11:08:56 -0700
Subject: [PATCH 3/5] 25 -> 26

---
 public/docs/dart/latest/guide/displaying-data.jade | 4 ++--
 public/docs/dart/latest/guide/setup.jade           | 2 +-
 public/docs/dart/latest/guide/user-input.jade      | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/public/docs/dart/latest/guide/displaying-data.jade b/public/docs/dart/latest/guide/displaying-data.jade
index 648c036e5a..9475c99b60 100644
--- a/public/docs/dart/latest/guide/displaying-data.jade
+++ b/public/docs/dart/latest/guide/displaying-data.jade
@@ -48,7 +48,7 @@
       description: Dart version of Angular 2 example, Displaying Data
       version: 0.0.1
       dependencies:
-        angular2: 2.0.0-alpha.25
+        angular2: 2.0.0-alpha.26
         browser: ^0.10.0
       transformers:
       - angular2:
@@ -359,7 +359,7 @@
       description: Displaying Data example
       version: 0.0.1
       dependencies:
-        angular2: 2.0.0-alpha.25
+        angular2: 2.0.0-alpha.26
         browser: ^0.10.0
       transformers:
       - angular2:
diff --git a/public/docs/dart/latest/guide/setup.jade b/public/docs/dart/latest/guide/setup.jade
index b0e405e294..a42907464e 100644
--- a/public/docs/dart/latest/guide/setup.jade
+++ b/public/docs/dart/latest/guide/setup.jade
@@ -30,7 +30,7 @@
     description: Getting Started example
     version: 0.0.1
     dependencies:
-      angular2: 2.0.0-alpha.25
+      angular2: 2.0.0-alpha.26
       browser: ^0.10.0
     transformers:
     - angular2:
diff --git a/public/docs/dart/latest/guide/user-input.jade b/public/docs/dart/latest/guide/user-input.jade
index f67350caba..d5ef2ec582 100644
--- a/public/docs/dart/latest/guide/user-input.jade
+++ b/public/docs/dart/latest/guide/user-input.jade
@@ -196,7 +196,7 @@
       description: User Input example
       version: 0.0.1
       dependencies:
-        angular2: 2.0.0-alpha.25
+        angular2: 2.0.0-alpha.26
         browser: ^0.10.0
       transformers:
       - angular2:

From 11b2102d8b100f9fbd812b59676d196704255e6e Mon Sep 17 00:00:00 2001
From: Kathy Walrath <kathyw@google.com>
Date: Fri, 5 Jun 2015 11:09:07 -0700
Subject: [PATCH 4/5] 23 -> 26 (quickstart)

---
 public/docs/dart/latest/quickstart.jade | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/public/docs/dart/latest/quickstart.jade b/public/docs/dart/latest/quickstart.jade
index aab648a5e6..4890baa8b5 100644
--- a/public/docs/dart/latest/quickstart.jade
+++ b/public/docs/dart/latest/quickstart.jade
@@ -30,14 +30,14 @@ p.
   p.
     In <code>pubspec.yaml</code>, add the angular2 and browser packages as dependencies.
     Angular 2 is changing rapidly, so specify an exact version:
-    <b>2.0.0-alpha.23</b>.
+    <b>2.0.0-alpha.26</b>.
 
   pre.prettyprint.linenums.lang-basic
     code.
       name: hello_world
       version: 0.0.1
       dependencies:
-        angular2: 2.0.0-alpha.23
+        angular2: 2.0.0-alpha.26
         browser: any
   p.
     In the same directory, run <code>pub get</code>

From 299700c26c258d82c2b0963fbd9a5f7babeea21e Mon Sep 17 00:00:00 2001
From: Kathy Walrath <kathyw@google.com>
Date: Fri, 5 Jun 2015 11:58:51 -0700
Subject: [PATCH 5/5] update quick start to 26, for realsies

---
 public/docs/dart/latest/quickstart.jade | 30 ++++++++++++-------------
 1 file changed, 15 insertions(+), 15 deletions(-)

diff --git a/public/docs/dart/latest/quickstart.jade b/public/docs/dart/latest/quickstart.jade
index 7836ca52f5..0d2a6ca513 100644
--- a/public/docs/dart/latest/quickstart.jade
+++ b/public/docs/dart/latest/quickstart.jade
@@ -38,14 +38,14 @@ p.
     specify the angular2 and browser packages as dependencies,
     as well as the angular2 transformer.
     Angular 2 is changing rapidly, so provide an exact version:
-    <b>2.0.0-alpha.25</b>.
+    <b>2.0.0-alpha.26</b>.
 
   code-example(language="yaml" format="linenums").
     name: hello_world
     version: 0.0.1
     dependencies:
-      angular2: 2.0.0-alpha.25
-      browser: ^0.10.0+2
+      angular2: 2.0.0-alpha.26
+      browser: ^0.10.0
     transformers:
     - angular2:
         entry_points: web/main.dart
@@ -79,8 +79,8 @@ p.
   code-example(language="dart" format="linenums").
     import 'package:angular2/angular2.dart';
     import 'package:angular2/src/reflection/reflection.dart' show reflector;
-    import 'package:angular2/src/reflection/reflection_capabilities.dart' show ReflectionCapabilities;
-
+    import 'package:angular2/src/reflection/reflection_capabilities.dart'
+        show ReflectionCapabilities;
 //- STEP 3 - Define a component ##########################
 .l-main-section
 
@@ -90,7 +90,7 @@ p.
     Update <code>web/main.dart</code>, adding the following code
     after the imports:
 
-  code-example(language="dart" format="linenums:5").
+  code-example(language="dart" format="linenums:6").
     @Component(
       selector: 'my-app'
     )
@@ -161,7 +161,7 @@ p.
   p.
     Add the following code to the bottom of <code>web/main.dart</code>:
 
-  code-example(language="dart" format="linenums:15").
+  code-example(language="dart" format="linenums:16").
     main() {
       reflector.reflectionCapabilities = new ReflectionCapabilities();
       bootstrap(AppComponent);
@@ -245,16 +245,16 @@ p.
 
   code-example(language="basic").
     &gt; <span class="blk">pub build</span>
-    Loading source assets...
-    Loading angular2 transformers...
+    Loading source assets... 
+    Loading angular2 transformers... 
     INFO: Formatter is being overwritten.
-    Building hello_world... (3.1s)
+    Building hello_world... (3.8s) 
     [Info from Dart2JS]:
     Compiling hello_world|web/main.dart...
     [Info from Dart2JS]:
-    Took 0:00:16.123086 to compile hello_world|web/main.dart.
-    Built 41 files to "build".
-  //- REGENERATE THIS OUTPUT - or delete it? - when updating from 2.0.0-alpha.25
+    Took 0:00:15.612746 to compile hello_world|web/main.dart.
+    Built 63 files to "build".
+  //- REGENERATE THIS OUTPUT - or delete it? - when updating from 2.0.0-alpha.26
 
   p.
     The generated JavaScript appears, along with supporting files,
@@ -273,8 +273,8 @@ p.
     name: hello_world
     version: 0.0.1
     dependencies:
-      angular2: 2.0.0-alpha.25
-      browser: ^0.10.0+2
+      angular2: 2.0.0-alpha.26
+      browser: ^0.10.0
     <span class="pnk">transformers:
     - angular2:
         entry_points: web/main.dart</span>