From 7195daa1161a581a19f83d81fa11b8545f6732a6 Mon Sep 17 00:00:00 2001
From: "Alex A. Naanou" <alex.nanou@gmail.com>
Date: Wed, 24 Aug 2016 02:16:40 +0300
Subject: [PATCH] working on docs..

Signed-off-by: Alex A. Naanou <alex.nanou@gmail.com>
---
 README.md | 24 ++++++++++--------------
 1 file changed, 10 insertions(+), 14 deletions(-)

diff --git a/README.md b/README.md
index b7b13e5..0fa1fa7 100644
--- a/README.md
+++ b/README.md
@@ -49,7 +49,7 @@ n.times = function(n){
 ```
 
 Note that we are manually calling the _super_ method and manually 
-returning and re-returning `this` in each implementation.
+returning and re-returning `this` in each implementation of `.times(..)`.
 
 Another thing to note here is that the code above, though quite simple is
 not reusable, i.e.:
@@ -67,12 +67,7 @@ var N = Actions({
   }]
 })
 
-
-```
-
-Now the extended:
-
-```javascript
+// Now we extend .times(..)
 var ExtendedN = Actions({
   times: [function(n){
     console.log(this.value, 'times', n)
@@ -89,7 +84,7 @@ And both objects can be used in the same way as before:
 
 
 ```javascript
-// We mix the two, but either can be used as above...
+// Here we mix the two, but either can be used stand-alone as above...
 var n = mix(N, ExtendedN) 
 
 n.value = 3
@@ -99,16 +94,17 @@ n
   .times(2)
 ```
 
-But now:
-- `this` is returned automatically
-- the _super_ method is called automatically
-- both `N` and `ExtendedN` are reusable in different inheritance chains
-  without any extra work needed.
+Now:
+- `this` is returned automatically enabling us to chain calls to `.times(..)`
+- the _super_ method is resolved and called automatically
+- both `N` and `ExtendedN` are independent of each other and reusable 
+  in different inheritance chains without any extra work needed.
+- _and more... (see below)_
 
 
 
 
-### Functionality:
+### What we get:
 - **Call _extended_ actions automatically**  
   All actions (methods) in a chain are guaranteed to get called if the 
   action is called.