docs: revised according to review.

Author: p7nov

examples/02_control_flow/01_When.md

@@ -1,6 +1,6 @@
 # When
 
-Instead of widely used `switch` statement, Kotlin provides the more flexible and clear `when` construction. It can be used either as a statement or as an expression.
+Instead of the widely used `switch` statement, Kotlin provides the more flexible and clear `when` construction. It can be used either as a statement or as an expression.
 
 ## When Statement
 
@@ -31,10 +31,10 @@ class MyClass
 </div>
 
 1. This is a `when` statement. 
-2. Checking whether `obj` equals to one.
-3. Checking whether `obj` equals to `Hello`.
-4. Type checking.
-5. Inverse type checking.
+2. Checks whether `obj` equals to one.
+3. Checks whether `obj` equals to `Hello`.
+4. Performs type checking.
+5. Performs inverse type checking.
 6. Default statement (might be omitted).
 
 Note that all branch conditions are checked sequentially until one of them is satisfied. So, only the first suitable branch will be executed.   
@@ -65,7 +65,7 @@ fun whenAssign(obj: Any): Any {
 </div>
 
 1. This is a `when` expression. 
-2. Setting the value to `"one"` if `obj` equals to one.
-3. Setting the value to one if `obj` equals to `Hello`.
-4. Setting the value to `false` if `obj` is an instance of `Long`.
-5. Setting the value "42" if none of the previous conditions are satisfied. Unlike in `when` _statement_, the default branch is usually required in `when` _expression_, except the case when the compiler can check that other branches cover all possible cases.
+2. Sets the value to `"one"` if `obj` equals to one.
+3. Sets the value to one if `obj` equals to `Hello`.
+4. Sets the value to `false` if `obj` is an instance of `Long`.
+5. Sets the value "42" if none of the previous conditions are satisfied. Unlike in `when` _statement_, the default branch is usually required in `when` _expression_, except the case when the compiler can check that other branches cover all possible cases.

examples/02_control_flow/02_Loops.md

@@ -23,7 +23,7 @@ fun main(args: Array<String>) {
 
 </div>
 
-1. Looping through each cake in the list.
+1. Loops through each cake in the list.
 
 ### `while` and `do-while`
 
@@ -54,12 +54,12 @@ fun main(args: Array<String>) {
 
 </div>
 
-1. Executing the block while the condition is true.
-2. Executing the block first and then checking the condition.
+1. Executes the block while the condition is true.
+2. Executes the block first and then checking the condition.
 
 ### Iterators
 
-You can define own iterators in your classes by implementing the `iterator` operator in them.
+You can define your own iterators in your classes by implementing the `iterator` operator in them.
 
 <div class="language-kotlin" theme="idea" data-min-compiler-version="1.3">
 
@@ -86,10 +86,10 @@ fun main() {
 
 </div>
 
-1. Defining an iterator in a class. It must be named `iterator` and have the `operator` modifier.
-2. Returning the iterator that meets the following method requirements:
+1. Defines an iterator in a class. It must be named `iterator` and have the `operator` modifier.
+2. Returns the iterator that meets the following method requirements:
   * `next()`: `Animal`
   * `hasNext()`: `Boolean`
-3. Looping through animals in the zoo with the user-defined iterator.
+3. Loops through animals in the zoo with the user-defined iterator.
 
 The iterator can be declared in the type or as an extension function.

examples/02_control_flow/03_Ranges.md

@@ -28,9 +28,9 @@ fun main() {
 
 </div>
 
-1. Iterating over a range starting from 0 up to 3 (inclusive).
-2. Iterating over a range with a custom increment step for consecutive elements.
-5. Iterating over a range in _reverse_ order.
+1. Iterates over a range starting from 0 up to 3 (inclusive).
+2. Iterates over a range with a custom increment step for consecutive elements.
+5. Iterates over a range in _reverse_ order.
 
 Char ranges are also supported: 
 
@@ -55,7 +55,7 @@ fun main() {
 
 </div>
 
-1. Iterating over a char range in alphabetical order.
+1. Iterates over a char range in alphabetical order.
 2. Char ranges support `step` and `downTo` as well.
 
 Ranges are also useful in `if` statements:
@@ -80,5 +80,5 @@ fun main() {
 
 </div>
 
-1. Checking if a value is in the range.
+1. Checks if a value is in the range.
 2. `!in` is the opposite of `in`.

examples/02_control_flow/05_Conditional expression.md

@@ -16,4 +16,4 @@ fun main() {
 
 </div>
 
-1. `if` is an expression here, i.e. it returns a value.
+1. `if` is an expression here: it returns a value.