Address feedback

Author: olafurpg

blog/_posts/2017-02-23-scalafix-v0.3.md

@@ -4,10 +4,14 @@ We are happy to announce the release of [scalafix v0.3][scalafix].
 This release introduces a new `Rewrite` and `Patch` API powered by the [scala.meta semantic API][meta-1.6].
 We are excited about this release because we believe it enables a number promising tooling applications.
 
-This first release of the scala.meta semantic API enables rewrites to query for the "symbol" of a name that appears in a Scala source file.
+Scala.meta recently had its first release of its semantic API; the semantic API provides operations to query information from the compiler.
+This has enabled rewrites in scalafix to query for the so-called "symbol" of a name that appears in a Scala source file.
 A symbol is a unique identifier of a definition such as a class, val, def or trait.
 This ability to query for symbols opens possibilities for a great number of refactorings including imports management and identifier renaming.
-To demonstrate what rewrites can be implemented with scalafix v0.3, let's take one example.
+
+The long-term mission of scalafix is to help automate the migration of deprecated Scala 2.x features to Dotty.
+However, scalafix can be used for more than migrating between Scala versions; it can also be used for ad-hoc library and application migrations.
+To demonstrate what rewrites can be implemented with scalafix v0.3, let's step through an example of a real usecase.
 
 ## Example: Xor to Either
 
@@ -30,7 +34,10 @@ Replace(Symbol("_root_.cats.data.Xor.Left."), q"Left")
 Replace(Symbol("_root_.cats.data.Xor.Right."), q"Right")
 ```
 
-To introduce new imports on renmae, it's possible to pass in `additionalImports`
+The `Symbol(_root_...data.Xor)` part is the scala.meta symbol referencing the class definition of `cats.data.Xor`.
+As we saw in the `either: Xor[HCursor` diff above, references to `Xor` should become `Either` after the rewrite.
+
+To introduce new imports on rename, it's possible to pass in `additionalImports`
 ```scala
 Replace(Symbol("_root_.cats.data.XorT."), q"EitherT",
         additionalImports = List(importer"cats.data.EitherT")),