README.md in script-0.0.3 vs README.md in script-0.0.4

@@ -1,13 +1,16 @@
-# Script<img width="40" align="left" src="https://cdn.codementor.io/assets/topic/category_header/ruby-on-rails-bc9ab2af8d92eb4e7eb3211d548a09ad.png"> 
+# Script[<img width="40" align="left" src="misc/ruby.png">](https://github.com/bmarkons/script#script)
+[![Build Status](https://semaphoreci.com/api/v1/bmarkons/script/branches/master/badge.svg)](https://semaphoreci.com/bmarkons/script)
+[![Gem Version](https://badge.fury.io/rb/script.svg)](https://badge.fury.io/rb/script)
 
-The Script is everything you need to make the most of Ruby, as fabulous scripting language.
+The Script is everything you need to make the most of Ruby - a fabulous scripting language. The one started with idea of having nicely formatted output, but ended up in much more...
 
 ###### Table of contents
 - [Setup](#setup)
 - [Usage](#usage)
   - [Steps](#steps)
+  - [Shareables](#shareables)
 - [Contributing](#contributing)
 - [License](#license)
 - [Code of Conduct](#code-of-conduct)
 
 ## Setup
@@ -36,38 +39,51 @@
 require "script"
 
 deploy = Script.new
 
 deploy.step("Setup tools") do
-
   `sudo apt-get install -y google-cloud-sdk kubectl`
   `gcloud auth activate-service-account $GCLOUD_SERVICE_ACCOUNT_NAME`
   `gcloud config set project dummy-project`
   `gcloud container clusters get-credentials default --zone us-east`
-  
 end
 
 deploy.step("Deploy docker image") do
-
   `docker pull dummy`
   `docker build --cache-from dummy -t dummy`
   `docker build -t scripter/script .`
   `docker push dummy`
-  
 end
 
 deploy.step("Deploy to Kubernetes cluster") do
-
   `kubectl apply -f k8s.yml --record`
-  
 end
 
 # Finally, run the script
 
 deploy.run
 ```
 
-The steps are run in order in which they are registered.
+The steps are run in order in which they are registered. The output from the script commands is nicely formatted and divided per steps:
+
+![output](https://i.imgur.com/a6F2iAh.png)
+
+In case of an exception in one of the steps, the execution of the script is aborted instantly.
+
+### Shareables
+
+In case you need to share data between steps, you can pass hash of shareables to the step block:
+
+```ruby
+script.step("Step 1") do |shareables|
+  shareables["environment"] = "production"
+end
+
+script.step("Step 2") do |shareables|
+  environment = shareables["environment"]
+  puts "Deploying on #{environment} environment"
+end
+```
 
 ## Contributing
 
 ```
 # Clone the repo