docs: revised according to review.

Author: p7nov

examples/04_functional/01_Higher-Order Functions.md

@@ -22,11 +22,11 @@ fun main() {
 
 </div>
 
-1. Declaring a higher-order function. It takes two integer parameters, `x` and `y`. Additionally, it takes another function `operation` as a parameter. The `operation` parameters and return type are also defined in the declaration.
-2. The higher order functions returns the result of `operation` invocation with the supplied agruments.
-3. Declaring a function that matches the `operation`signature.
-4. Invoking the higher-order function passing in two integer values and the function argument `::sum`. `::` is the notation that  references a function by name in Kotlin.
-5. Invoking the higher-order function passing in a lambda as a function argument. Looks more clear, doesn't it?
+1. Declares a higher-order function. It takes two integer parameters, `x` and `y`. Additionally, it takes another function `operation` as a parameter. The `operation` parameters and return type are also defined in the declaration.
+2. The higher order function returns the result of `operation` invocation with the supplied agruments.
+3. Declares a function that matches the `operation`signature.
+4. Invokes the higher-order function passing in two integer values and the function argument `::sum`. `::` is the notation that references a function by name in Kotlin.
+5. Invokes the higher-order function passing in a lambda as a function argument. Looks clearer, doesn't it?
 
 ### Returning Functions
 
@@ -47,8 +47,8 @@ fun main() {
 
 </div>
 
-1. Declaring a higher-order function that returns a function.
-2. Declaring a function matching the signature.
-3. Invoking `operation` to get the result assigned to a variable. Here `func` becomes `square` which is returned by `operation`.
-4. Invoking `func`. The `square` function is actually executed.
+1. Declares a higher-order function that returns a function.
+2. Declares a function matching the signature.
+3. Invokes `operation` to get the result assigned to a variable. Here `func` becomes `square` which is returned by `operation`.
+4. Invokes `func`. The `square` function is actually executed.
 

examples/04_functional/03_extensionFunctions.md

@@ -1,6 +1,6 @@
 # Extension Functions and Properties
 
-Kotlin lets you add new members to any class with the [extensions](https://kotlinlang.org/docs/reference/extensions.html) mechanism. Namely, there are two types of extensions: extension functions and extension properties. They look pretty much like usual functions and properties with the only difference: you need to specify the type that you extend.
+Kotlin lets you add new members to any class with the [extensions](https://kotlinlang.org/docs/reference/extensions.html) mechanism. Namely, there are two types of extensions: extension functions and extension properties. They look a lot like normal functions and properties but with one important difference: you need to specify the type that you extend.
 
 <div class="language-kotlin" theme="idea" data-min-compiler-version="1.3">
 
@@ -28,11 +28,11 @@ fun main() {
 
 </div>
 
-1. Defining simple models of `Item` and `Order`. `Order` can contain a collection of `Item` objects.
-2. Adding extension functions for the `Order` type.  
-3. Adding an extension property for the `Order` type.
-4. Calling extension functions directly on an instance of `Order`.
-5. Accessing the extension property on an instance of `Order`.
+1. Defines simple models of `Item` and `Order`. `Order` can contain a collection of `Item` objects.
+2. Adds extension functions for the `Order` type.  
+3. Adds an extension property for the `Order` type.
+4. Calls extension functions directly on an instance of `Order`.
+5. Accesses the extension property on an instance of `Order`.
 
 It is even possible to execute extensions on `null` references. In an extension function, you can check the object for `null` and use the result in your code: