Incorporating Bob's feedback.
diff --git a/README.md b/README.md
index cb7569a..afe3b9e 100644
--- a/README.md
+++ b/README.md
@@ -9,20 +9,8 @@
(by far the most difficult), intelligent line wrapping.
It has no problems with nested collections, function
expressions, long argument lists, or otherwise tricky code.
-Only white space is affected.
-To use the formatter, you can either run the **dartfmt** command or use the
-dart_style API.
-
-IDEs and editors that support Dart usually provide easy ways to run the
-formatter. For example, in WebStorm you can right-click a .dart file
-and then choose **Reformat with Dart Style**.
-
-**Note:** dartfmt is safe to run automatically. We encourage you to add
-it to your build scripts.
-
-The following example shows a complex expression, with most white
-space removed, and the code that results when using dartfmt.
+The formatter turns code like this:
```
// BEFORE formatting
@@ -31,7 +19,7 @@
tag=='link'&&(rel=='stylesheet'||rel=='import')) {}
```
-Dartfmt converts this to:
+into:
```
// AFTER formatting
@@ -41,6 +29,9 @@
tag == 'link' && (rel == 'stylesheet' || rel == 'import')) {}
```
+The formatter will never break your code—you can safely invoke it
+automatically from build and presubmit scripts.
+
## Getting dartfmt
Dartfmt is included in the Dart SDK, so you might want to add the SDK's bin
@@ -62,6 +53,10 @@
## Using dartfmt
+IDEs and editors that support Dart usually provide easy ways to run the
+formatter. For example, in WebStorm you can right-click a .dart file
+and then choose **Reformat with Dart Style**.
+
Here's a simple example of using dartfmt on the command line:
```
