readme and tool updates

Author: kevmoo

README.md

@@ -1,6 +1,5 @@
 [![Build Status](https://travis-ci.org/dart-lang/source_gen.svg?branch=master)](https://travis-ci.org/dart-lang/source_gen)
 [![Coverage Status](https://coveralls.io/repos/dart-lang/source_gen/badge.svg?branch=master)](https://coveralls.io/r/dart-lang/source_gen)
-[![Stories in Ready](https://badge.waffle.io/dart-lang/source_gen.png?label=ready&title=Ready)](https://waffle.io/dart-lang/source_gen)
 
 _**Highly experimental. Expect breaking changes.**_
 
@@ -14,18 +13,20 @@ _**Highly experimental. Expect breaking changes.**_
 
 ## Example
 
-Given a library `example.dart`:
+Given a library `example.dart` with an `Person` class annotated with
+`@JsonSerializable`:
 
 ```dart
-library source_gen.example.example;
+library source_gen.example;
 
 import 'package:source_gen/generators/json_serializable.dart';
-
 part 'example.g.dart';
 
 @JsonSerializable()
 class Person extends Object with _$PersonSerializerMixin {
   final String firstName, middleName, lastName;
+
+  @JsonKey('date-of-birth')
   final DateTime dateOfBirth;
 
   Person(this.firstName, this.lastName, {this.middleName, this.dateOfBirth});
@@ -37,31 +38,26 @@ class Person extends Object with _$PersonSerializerMixin {
 `source_gen` creates the corresponding part `example.g.dart`:
 
 ```dart
-part of source_gen.example.example;
-
-// **************************************************************************
-// Generator: JsonGenerator
-// Target: class Person
-// **************************************************************************
+part of source_gen.example;
 
-Person _$PersonFromJson(Map<String, Object> json) => new Person(
+Person _$PersonFromJson(Map json) => new Person(
     json['firstName'], json['lastName'],
     middleName: json['middleName'],
-    dateOfBirth: json.containsKey('dateOfBirth')
-        ? DateTime.parse(json['dateOfBirth'])
-        : null);
+    dateOfBirth: json['date-of-birth'] == null
+        ? null
+        : DateTime.parse(json['date-of-birth']));
 
 abstract class _$PersonSerializerMixin {
   String get firstName;
   String get middleName;
   String get lastName;
   DateTime get dateOfBirth;
-  Map<String, Object> toJson() => {
-    'firstName': firstName,
-    'middleName': middleName,
-    'lastName': lastName,
-    'dateOfBirth': dateOfBirth == null ? null : dateOfBirth.toIso8601String()
-  };
+  Map<String, dynamic> toJson() => <String, dynamic>{
+        'firstName': firstName,
+        'middleName': middleName,
+        'lastName': lastName,
+        'date-of-birth': dateOfBirth?.toIso8601String(),
+      };
 }
 ```
 
@@ -76,15 +72,13 @@ Extend the `Generator` class to plug into `source_gen`.
 
 ## Running generators
 
-Create a script that invokes the [generate][] method.
-
-Alternatively, you can create a `build.dart` file which calls the [build]
-method. You can use the [build_system package][] to enjoy this automatic workflow.
-
-*Note: The original design was meant to work with the
-[Dart Editor build system][]. Dart Editor is unsupported as of Dart 1.11.*
+`source_gen` is based on the `build` package (
+  [pub](https://pub.dartlang.org/packages/build),
+  [GitHub](https://github.com/dart-lang/build)).
 
-See [build.dart][] in the repository for an example.
+See `build.dart` and `watch.dart` in the `tool` directory. Both reference
+`tool/phases.dart`, which contains information mapping `source_gen` generators
+to target files.
 
 ## source_gen vs Dart Transformers
 [Dart Transformers][] are often used to create and modify code and assets as part
@@ -111,5 +105,3 @@ detail*.
 [build.dart]: https://github.com/dart-lang/source_gen/blob/master/build.dart
 [generate]: http://www.dartdocs.org/documentation/source_gen/latest/index.html#source_gen/source_gen@id_generate
 [build]: http://www.dartdocs.org/documentation/source_gen/latest/index.html#source_gen/source_gen@id_build
-[Dart Editor build system]: https://www.dartlang.org/tools/editor/build.html
-[build_system package]: https://pub.dartlang.org/packages/build_system

build.dart

@@ -8,5 +8,5 @@ import 'package:build/build.dart';
 import 'phases.dart';
 
 main() async {
-  build(phases, deleteFilesByDefault: true);
+  await build(phases, deleteFilesByDefault: true);
 }

tool/build.dart

@@ -10,7 +10,7 @@ set -e
 pub run test
 
 # Run the build.dart file - just to make sure it works
-dart --checked build.dart
+dart --checked tool/build.dart
 
 # Install dart_coveralls; gather and send coverage data.
 if [ "$COVERALLS_TOKEN" ] && [ "$TRAVIS_DART_VERSION" = "stable" ]; then