From d2e26271ca4f0a6c1dcaebd39fdf3a1a0681cf7e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A1bio=20Pakk=20Selmi-Dei?=
 <31698178+fabiopakk@users.noreply.github.com>
Date: Tue, 12 Feb 2019 18:04:18 +0100
Subject: [PATCH] More precise wording in abstract-type-members.md

Dear reviewers,

I summarize below the reason for my changes:
* Line 37: "Notice how we can use yet another abstract type U as an upper-type-bound." -> That suggests that T <: U, which is not the case.
* Line 56: Make it clear that the anonymous class is providing concrete types to abstract type members.
* Line 78: The word 'members' is a must, as 'abstract type' is a broader than intended term. Would also be nice to show and example where abstract type members can't be rewritten with type parameters as claimed.
---
 _tour/abstract-type-members.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/_tour/abstract-type-members.md b/_tour/abstract-type-members.md
index f60cb61766..90421a4491 100644
--- a/_tour/abstract-type-members.md
+++ b/_tour/abstract-type-members.md
@@ -34,7 +34,7 @@ abstract class SeqBuffer extends Buffer {
   def length = element.length
 }
 ```
-Notice how we can use yet another abstract `type U` as an upper-type-bound. This `class SeqBuffer` allows us to store only sequences in the buffer by stating that type `T` has to be a subtype of `Seq[U]` for a new abstract type `U`.
+Notice how we can use yet another abstract type `U` in the specification of an upper-type-bound for `T`. This `class SeqBuffer` allows us to store only sequences in the buffer by stating that type `T` has to be a subtype of `Seq[U]` for a new abstract type `U`.
 
 Traits or [classes](classes.html) with abstract type members are often used in combination with anonymous class instantiations. To illustrate this, we now look at a program which deals with a sequence buffer that refers to a list of integers:
 
@@ -53,7 +53,7 @@ val buf = newIntSeqBuf(7, 8)
 println("length = " + buf.length)
 println("content = " + buf.element)
 ```
-Here the factory `newIntSeqBuf` uses an anonymous class implementation of `IntSeqBuf` (i.e. `new IntSeqBuffer`), setting `type T` to a `List[Int]`.
+Here the factory `newIntSeqBuf` uses an anonymous class implementation of `IntSeqBuf` (i.e. `new IntSeqBuffer`) to set the abstract type `T` to the concrete type `List[Int]`.
 
 It is also possible to turn abstract type members into type parameters of classes and vice versa. Here is a version of the code above which only uses type parameters:
 
@@ -75,4 +75,4 @@ println("length = " + buf.length)
 println("content = " + buf.element)
 ```
 
-Note that we have to use [variance annotations](variances.html) here (`+T <: Seq[U]`) in order to hide the concrete sequence implementation type of the object returned from method `newIntSeqBuf`.  Furthermore, there are cases where it is not possible to replace abstract types with type parameters.
+Note that we have to use [variance annotations](variances.html) here (`+T <: Seq[U]`) in order to hide the concrete sequence implementation type of the object returned from method `newIntSeqBuf`.  Furthermore, there are cases where it is not possible to replace abstract type members with type parameters.