Address comments

Author: biboudis

docs/blog/_posts/2019-12-20-21th-dotty-milestone-release.md

@@ -1,6 +1,6 @@
 ---
 layout: blog-page
-title: Announcing Dotty 0.21.0-RC1 – ❄️ Feature Freeze ❄️
+title: Announcing Dotty 0.21.0-RC1
 author: Aggelos Biboudis
 authorImg: /images/aggelos.png
 date: 2019-12-21
@@ -14,25 +14,37 @@ complementary. We present new syntax for given extensions, matches and pattern
 matching over quotes. We are also happy to announce that SemanticDB extraction
 is now supported!
 
-# ❄️ Feature Freeze ❄️
+# Feature Complete!
+
 This release is a HUGE milestone for us, for Dotty, for Scala 3, for our community. Since that
 [initial commit](https://github.com/lampepfl/dotty/commit/90962407e72d88f8f3249ade0f6bd60ff15af5ce)
 on the 6th December of 2012 when the only feature was the basic structure of a
 compiler based on the DOT calculus, we have come a long way.
 
-7 years and 20k commits later we are happy to announce that we are entering the
-*feature freeze* phase of Scala 3 ❄️❄️☃️. This means that with this release we
-stop adding new features ([Overview of Features](https://dotty.epfl.ch/docs/reference/overview.html)) and we focus on:
+7 years and 20k commits later we are happy to announce that we are now _feature-complete_ for Scala 3.
+This means that with this release we stop adding new features and we focus on:
 
 - bug fixing and general quality assurance towards the final release 🐛
 - performance engineering 🏎️
 - documentation improvements 📕
 - education 👨‍🏫
 
+Being feature complete does not mean that every detail of Scala-3 is cast in
+stone yet. Some details can still change, or be enabled conditionally, or even
+be dropped entirely. That will depend on the additional experience we gain over
+the next months, in particular the feedback we receive from the community and
+the SIP committee. But the envelope of what will (most likely) be in Scala 3 is
+now defined and implemented.
+
+For an overview of the feature envelope that Scala 3 carries you can read our
+[Overview](https://dotty.epfl.ch/docs/reference/overview.html) page.
+For a more detailed discussion on the transition to Scala 3 you can read the
+[Scala 2 roadmap update: The road to Scala 3](https://www.scala-lang.org/2019/12/18/road-to-scala-3.html).
+
 ### Community-build
 
-Feature Freeze (FF) doesn't mean that development slows down. On the contrary!
-FF means that we can now put the Scala 3 compiler under heavy load, getting it
+Being feature complete doesn't mean that development slows down. On the contrary!
+It means that we can now put the Scala 3 compiler under heavy load, getting it
 ready for industrial strength applications. At the moment we have 23
 projects on our community projects and we expect this number to go up!
 
@@ -47,7 +59,7 @@ from the root of the dotty repo.
 
 ### New Issues
 
-Firstly thank you for all the hard work in issue reporting! FF means that our
+Firstly thank you for all the hard work in issue reporting! Being feature complete means that our
 issue tracker will now be more important than ever. We encourage you to stress
 the compiler and report self contained test-cases! Bug minimization is hard and
 a form of art! Help us unearth those nasty bugs! ✊
@@ -238,16 +250,23 @@ You can read more on our docs [Match Expressions](https://dotty.epfl.ch/docs/ref
 ## New quoted pattern matching
 
 We introduce a high-level API to deconstruct or extract values out of `Expr`
-using pattern matching. It consists of quoted patterns that allows to
-deconstruct complex code that contains a precise structure, types or methods.
+using pattern matching. It consists of high-level extractors for getting static
+information out of exprs and, of quoted patterns that allows to deconstruct
+complex code that contains a precise structure, types or methods.
 Patterns `'{ ... }` can be placed in any location where Scala expects a pattern.
 
-For example, the following snippet implements a simple, 1-level, non-recursive
-rewriter macro for exponents. `rewrite` is a an inline method definition
-designating a macro. To inspect an `expr` value we can now use the quoted syntax
-as patterns inside a match expression. Notice that quotes designate patterns and
-`$`, the familiar syntax for splices is used to _extract_ (capture) information
-out of a pattern.
+The new extractors are summarized below:
+
+* `scala.quoted.matching.Const`: matches an expression a literal value and returns the value.
+* `scala.quoted.matching.ExprSeq`: matches an explicit sequence of expresions and returns them. These sequences are useful to get individual `Expr[T]` out of a varargs expression of type `Expr[Seq[T]]`.
+* `scala.quoted.matching.ConstSeq`:  matches an explicit sequence of literal values and returns them.
+
+The following snippet demonstrates the new _quoted patterns_ implementing a
+simple, 1-level, non-recursive rewriter macro for exponents. `rewrite` is a an
+inline method definition designating a macro as usual. To inspect an `expr`
+value with friendly syntax we can now use the quoted syntax as patterns inside a
+match expression. Notice that quotes designate patterns and `$`, the familiar
+syntax for splices is used to _extract_ (capture) information out of a pattern.
 
 ```scala
 inline def rewrite(expr: => Double): Double = ${rewrite('expr)}
@@ -269,17 +288,16 @@ def rewrite(expr: Expr[Double])(given QuoteContext): Expr[Double] = {
 }
 ```
 
-Additionally to the quoted patterns we provide extractors in
-`scala.quoted.matching` that extract static information from `Expr`s. Namely
-`Const`, `ExprSeq` and `ConstSeq`.
-
 To learn more read our docs on [pattern matching over quotes](https://dotty.epfl.ch/docs/reference/metaprogramming/macros.html#pattern-matching-on-quoted-expressions).
 
 ## Added support for SemanticDB extraction
 
-Scala 3 now offers support for SemanticDB extraction producing `.semanticdb` files.
-Users can use the `-Ysemanticdb` compiler flag to enable exporting SemanticDB files. Providing `-semanticdb-target` allows the user to select a separate target destination for the `META-INF` directory that stores SemanticDB files and `-sourceroot` to calculate a relative path for SemanticDB files within `META-INF`
-
+Scala 3 now offers support for SemanticDB extraction producing `.semanticdb`
+files. Users can use the `-Ysemanticdb` compiler flag to enable exporting
+SemanticDB files. Providing `-semanticdb-target` allows the user to select a
+separate target destination for the `META-INF` directory that stores SemanticDB
+files and `-sourceroot` to calculate a relative path for SemanticDB files within
+`META-INF`.
 
 # Let us know what you think!