diff --git a/doc/Migrating code to new API.md b/doc/Migrating code to new API.md
index f8e2721b..24471479 100644
--- a/doc/Migrating code to new API.md	
+++ b/doc/Migrating code to new API.md	
@@ -77,4 +77,4 @@ But Arduino JSON v4 doesn't, instead you need to write this:
 
 	array.printTo(Serial);
 
-Note: there is a good reason for that: reducing the size of `JsonArray` and `JsonObject`.
\ No newline at end of file
+Note: there was a good reason for removing that feature, and it's reducing the size of `JsonArray` and `JsonObject`.
\ No newline at end of file
diff --git a/doc/Using the library with Arduino.md b/doc/Using the library with Arduino.md
index 31efebc4..5530289a 100644
--- a/doc/Using the library with Arduino.md	
+++ b/doc/Using the library with Arduino.md	
@@ -1,7 +1,7 @@
-Using the library without Arduino
-=================================
+Using the library with Arduino
+==============================
 
-This library is primarily design to be used with the Arduino IDE and therefore has a simplified setup procedure for that purpose.
+This library is primarily design to be used with the Arduino IDE and therefore has a simplified setup procedure for that environment.
 If you don't use the Arduino IDE, please read [Using the library without Arduino](Using the library without Arduino.md).
 
 ## Install the library
@@ -18,7 +18,6 @@ Click `File` / `Example` / `ArduinoJson`.
 
 ![Screen capture of Arduino IDE](http://i.imgur.com/g5UwkVh.png)
 
-
 ## Use the library in your sketches
 
 Just add the following line at the top of your program:
diff --git a/doc/Using the library without Arduino.md b/doc/Using the library without Arduino.md
index 3fbb4043..05c307a9 100644
--- a/doc/Using the library without Arduino.md	
+++ b/doc/Using the library without Arduino.md	
@@ -1,7 +1,7 @@
 Using the library without Arduino
 =================================
 
-This library is primarily design to be used with the Arduino IDE and therefore has a simplified setup procedure for that purpose.
+This library is primarily design to be used with the Arduino IDE and therefore has a simplified setup procedure for that environment.
 If you use the Arduino IDE, please read [Using the library with Arduino](Using the library with Arduino.md).
 
 However, it can be used without Arduino IDE with very little effort.