Address feedback

Author: olafurpg

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

@@ -5,8 +5,12 @@ by: Ólafur Páll Geirsson
 title: "Refactor with scalafix v0.3"
 ---
 
-I am happy to announce the release of [scalafix v0.3][scalafix].
-This release uses the new scala.meta semantic API to provide a re-designed `Rewrite` and `Patch` API for refactorings.
+I am happy to announce the release of [scalafix v0.3][scalafix], a library and tool to rewrite Scala source code.
+The long-term mission of scalafix is to help automate the migration of between Scala versions.
+However, as I hope to demonstrate in this post, scalafix can be used for more than just migrating between Scala versions.
+Scalafix can also be used for ad-hoc library and application migrations.
+
+Scalafix v0.3 uses the new scala.meta semantic API to provide a re-designed `Rewrite` and `Patch` API to implement custom refactorings.
 Let me explain what that means word by word.
 
 > Note. This is the second post on scalafix and scala.meta. You might be
@@ -46,7 +50,7 @@ Example token patches are `Remove(token)` and `AddLeft(token, toAdd: String)`, w
 
 Tree patches are high-level and allow rewrite author to declaratively explain what operation to perform.
 An example tree patch is `AddGlobalImport(importer)`, which adds a new import to the top of a file if it does not exist.
-Observe that `AddGlobalImport` does not worry about token-level details such as whether the user groups imports by prefix (e.g., `import a.{b, c}`).
+Observe that `AddGlobalImport` does not worry about token-level details such as whether the user groups imports by prefix (`import a.{b, c}`) or not (`import a.b; import a.c`).
 
 Tree and token patches build a small algebra of operations that can be composed to build complex refactorings.
 A challenge with composing patches is to figure out what to do on conflicts.
@@ -113,10 +117,6 @@ By using scalafix as a library, you have full control of how, where and when to
 The recommended way to use scalafix as tool is the [`sbt-scalafix`][sbt-scalafix] plugin.
 It's possible define custom tree patches in the [`.scalafix.conf` configuration file][config-patches].
 
-The long-term mission of scalafix is to help automate the migration of deprecated Scala 2.x features to Dotty.
-However, as I have demonstrated in this post, scalafix can be used for more than just migrating between Scala versions.
-Scalafix can also be used for ad-hoc library and application migrations.
-
 I am excited to see what applications the community can build with scala.meta and scalafix.
 Some promising ideas that have floated around include
 
@@ -127,6 +127,7 @@ Some promising ideas that have floated around include
   code-generate a version of the library that uses cats instead.
 - build a code search web-interface with "jump to definition" functionality
   powered by the scala.meta's semantic database.
+- replace usage of `any2stringadd` with string interpolators or explicit `.toString`.
 - replace usage of `scala.Seq`, which can be mutable, in favor of `scala.collection.immutable.Seq`.
 
 If this sounds exciting to you, join us!