Fixes based on feedback.

Author: DarkDimius

docs/blog/_posts/2017-05-31-first-dotty-milestone-release.md

@@ -5,7 +5,7 @@ author: Dmytro Petrashko
 authorImg: /images/petrashko.jpg
 ---
 
-Today, we excited to release Dotty version 0.1.2-RC1.  This release
+Today, we are excited to release Dotty version 0.1.2-RC1.  This release
 serves as a technology preview that demonstrates new language features
 and the compiler supporting them.
 
@@ -16,7 +16,7 @@ and the compiler supporting them.
 
 _Dotty_ is the project name for a language and compiler that
 is slated to become Scala 3.0. This is an ongoing development,
-developed transparently as open source software. The Dotty project
+transparently developed as open source software. The Dotty project
 started more than 4 years ago. It reached a major milestone in 2015 by
 achieving
 [bootstrap](http://dotty.epfl.ch/blog/2015/10/23/dotty-compiler-bootstraps.html),
@@ -80,14 +80,11 @@ See here for the full [release notes](http://dotty.epfl.ch/docs/release-notes/0.
 
 ## Release schedule
 
-We are adopting a time-based release schedule:
+Starting from this release, we are adopting a time-based release schedule:
 - Nightly builds will be published, for those wanting to be at the forefront of
   development.
-- Every 6 weeks, a release candidate will be cut based on the last nightly build,
-  the release candidates let library authors test their code in advance of each
-  release. Multiple release candidates may be released during each 6 weeks
-  period to fix regressions.
-- Every 6 weeks, the last release candidate becomes a release.
+- Every 6 weeks, a release candidate will be cut based on the latest nightly build.
+- Every 6 weeks, the latest release candidate becomes a release.
 
 At the end of 6 weeks, the milestone will be promoted to a stable release.
 See here for the full [version number explanation](http://dotty.epfl.ch/docs/usage/version-numbers.html).

docs/docs/release-notes/0.1.2.md

@@ -4,10 +4,10 @@ title: 0.1.2 release notes
 ---
 
 0.1.2 will be the first public release of Dotty.
-Being first, those notes are incomplete.
-This document is work in progress until 0.1.2-final is released.
-This note is up-to-date based on 0.1.2-RC1 and will be updated 
-with changes that happen during RC stabilization cycle.
+Being first one, those notes are incomplete.
+This document is a work in progress until 0.1.2-final is released.
+These notes are up-to-date based on 0.1.2-RC1 and will be updated 
+with changes that happen during the RC stabilization cycle.
 
 # Required Java Version
 
@@ -18,18 +18,15 @@ Dotty 0.1.2 targets Java 8. We don't have plans so far to add support for earlie
 # Reporting Bugs / Known Issues
 
 Please [file](https://github.com/lampepfl/dotty/issues) any bugs you encounter. If you’re unsure whether something is a bug, 
-please ask on Dotty [gitter channel](https://github.com/lampepfl/dotty).
+please ask on the Dotty [gitter channel](https://github.com/lampepfl/dotty).
 
-# SBT builds dotty that builds dotty
+# DottyDoc
 
-
-# Dotty Doc
-
-Dotty has added support for Dotty Doc.
+Dotty has added support for DottyDoc.
 Actually, the dotty documentation site [http://dotty.epfl.ch/docs/](http://dotty.epfl.ch/docs/) is generated by it.
-Looks nice, doesn't it?
+Looks nice, doesn’t it?
 
-#Other implemented features:
+# Other implemented features:
 
 This release ships with the following features:
 
@@ -39,24 +36,24 @@ This release ships with the following features:
  - Enumerations by [@odersky] [\[4\]][4] [\[5\]][5] [\[6\]][6]
  - Implicit By-Name Parameters by [@odersky] [\[7\]][7]
  - Miniphases-based design by [@darkdimius], [@odersky] and [@lhotak] [\[8\]][8]
- - @static methods support by [@darkdmius] [\[9\]][9]
+ - `@static` methods support by [@darkdmius] [\[9\]][9]
  - Non-blocking lazy vals by [@darkdimius] [\[10\]][10]
  - JVM code emission by [@magarciaEPFL] and [@darkdimius] [\[11\]][11]
- - efficient multi-dimensional array allocation by [@darkdimius] [\[12\]][12]
- - default-method based trait composition [@odersky] and [@darkdimius] [\[13\]][13] [\[14\]][14]
+ - Efficient multi-dimensional array allocation by [@darkdimius] [\[12\]][12]
+ - Default-method based trait composition [@odersky] and [@darkdimius] [\[13\]][13] [\[14\]][14]
  - Trait parameters by [@odersky] [\[15\]][15]
  - Working contravariant implicits by [@odersky] [\[16\]][16]
  - Option-less pattern matching by [@odersky], [@darkdimius] and [@OlivierBlanvillain] [\[17\]][17]
  - SAM-based anonymous functions by [@magarciaEPFL], [@darkdimius] and [@retronym] [\[18\]][18]
- - Patter matching support by [@darkdimius] [\[19\]][19]
+ - Pattern matching support by [@darkdimius] [\[19\]][19]
  - Value classes support by [@smarter] and [@darkdimius] [\[20\]][20]
- - Pattern matching exhaustively checks by [@liufengyun] [\[21\]][21]
+ - Pattern matching exhaustivity checks by [@liufengyun] [\[21\]][21]
  - Tailrec optimization by [@darkdimius] [\[22\]][22] [\[23\]][23]
- - VS code protocol implementation by [@smarter] [\[24\]][24]
+ - Language server protocol implementation by [@smarter] [\[24\]][24]
  - VS code plugin by [@smarter] [\[24\]][24]
- - Vulpix: new test-suite by [@felixmulder] that replaces partest by [@vsalvis] [\[25\]][25]
- - java parser by [@olhotak] [\[26\]][26]
- - local optimizations(-optimise) by [@darkdimius] and [@OlivierBlanvillain] [\[27\]][27]
+ - Vulpix: new test-suite driver by [@felixmulder] that replaces partest by [@vsalvis] [\[25\]][25]
+ - Java parser by [@olhotak] [\[26\]][26]
+ - local optimizations (-optimise) by [@darkdimius] and [@OlivierBlanvillain] [\[27\]][27]
  - sbt support by [@smarter] [\[28\]][28]
  - DottyDoc by [@felixmulder] [\[29\]][29]
  - Implicit Function Types by [@odersky] [\[30\]][30]
@@ -110,7 +107,7 @@ This release ships with the following features:
 [33]: http://dotty.epfl.ch/docs/reference/inline.html
 
 # Contributors
-Dotty team and contributes have closed 750 issues and has merged a total of 1258 pull requests.
+The Dotty team and contributors have closed 750 issues and have merged a total of 1258 pull requests.
 
 Concretely, according to
 

docs/docs/usage/version-numbers.md

@@ -5,10 +5,13 @@ title: "Version numbers"
 
 Dotty uses multiple schemes for version numbering.
 
-Stable releases have version numbers of the form `0.${x}.${y}`, where x is a main version and y is a bug-fix update id.
+Stable releases have version numbers of the form `0.${x}.${y}`, where `x` is a main version and `y` is a bug-fix update id.
 
-Release candidates version numbers have the form `0.${x}.${y}-RC${z}`. Release candidates are updated by incrementing `${z}`.
+Release candidates version numbers have the form `0.${x}.${y}-RC${z}`. 
 Every 6 weeks, the latest release candidate is promoted to stable and becomes version `0.${x}.${y}`.
+The release candidates let library authors test their code in advance of each
+release. Multiple release candidates may be released during each 6 weeks
+period to fix regressions and are differentiated by `z`.
 
 Nightlies have version numbers of the form `0.${x}.${y}-bin-${date}-${sha}-NIGHTLY`.
 Every 6 weeks, the latest nightly is promoted to release candidate becomes version `0.${x}.${y}-RC1`.