README.md in tamashii-client-0.1.1 vs README.md in tamashii-client-0.1.2

@@ -1,18 +1,18 @@
----
-tags: tamashii, readme
----
-
-Tamashii Client [![Gem Version](https://badge.fury.io/rb/tamashii-client.svg)](https://badge.fury.io/rb/tamashii-client) 
+Tamashii Client [![Gem Version](https://badge.fury.io/rb/tamashii-client.svg)](https://badge.fury.io/rb/tamashii-client)
 ===
 
-Tamashii Client is the client side of the WebSocket framework [Tamashii](https://github.com/tamashii-io/tamashii). It is event-driven and it provides high-level API for users to communicates with WebSocket server easily. 
+Tamashii Client is the websocket client for the  [Tamashii](https://github.com/tamashii-io/tamashii) project. It is event-driven and it provides high-level API for users to communicates with WebSocket server easily.
 
 ## Installation
 
-Add the following code to your `Gemfile`
+Add the following code to your `Gemfile`:
 
+```ruby
+gem 'tamashii-client'
+```
+
 And then execute:
 ```ruby
 $ bundle install
 ```
 
@@ -40,23 +40,24 @@
   host "echo.websocket.org"
   # the port to connect with. 443 for HTTPS and WSS
   # Note the current version client does not infer the port from 'use_ssl'
   # So you must explictly specifiy the port to use
   port 443
-  # the log file for internel connection log 
+  # the log file for internel connection log
   # default is STDOUT
   log_file 'tamashii.log'
 end
 
 client = Tamashii::Client::Base.new
-@server_opened = false 
+@server_opened = false
 
 # callback for server opened
 # called when the WebSocket connection is readt
-client.on(:open) do  
+client.on(:open) do
   @server_opened = true
 end
+
 # callback for receving messages
 # The data received is represented in a byte array
 # You may need to 'pack' it back to Ruby string
 client.on(:message) do |message|
   puts "Received: #{message.pack('C*')}"
@@ -64,23 +65,23 @@
 
 
 # sending loop
 # We send a request to server every second and terminates after 10 seconds
 # In the begining, the server is not opened so the sending may fail.
-count = 0 
+count = 0
 loop do
   sleep 1
   if @server_opened # can also use 'client.opened?'
     client.transmit "Hello World! #{count}"
   else
     puts "Unable to send #{count}: server not opened"
-  end 
+  end
   count += 1
   if count >= 10
     client.close
     break
-  end 
+  end
 end
 ```
 
 The [wss://echo.websocket.org](wss://echo.websocket.org) will echo the messages back to the client. So if everything works fine, you will see following output:
 
@@ -125,35 +126,37 @@
 end
 ```
 
 ### The events and callbacks
 
-These are events in the Tamashii Client. You can use `on` method to register callbacks for them. 
+These are events in the Tamashii Client. You can use `on` method to register callbacks for them.
 - `socket_opened`
-    - When the low-level io socket (`TCPSocket` or `OpenSSL::SSL::SSLSocket`) successfully connected to the server. 
-    - Receving this event does not imply the server supports WebSocket.
+    - When the low-level io socket (`TCPSocket` or `OpenSSL::SSL::SSLSocket`) successfully connected to the server.
+    - Receving this event does not imply the server supports WebSocket. Client still cannot send messages at this moment
 - `open`
     - When the WebSocket handshake is finished and the connection is opened
-    - Client can start sending data to server after receiving this event.
+    - Client can start sending messages to server after receiving this event.
+    - Fired after `socket_opened`
 - `message`
     - When the client receives the WebSocket payload from server.
     - The message payload will be pass as the argument of the callback.
 - `error`
     - When there is a protocol error due to bad data sent by the other peer.
     - This event is purely informational, you do not need to implement error recovery.
     - The error object will be pass as the argument of the callback.
 - `close`
-    - When the WebSocket is closed **normally**. 
-    - Will **NOT** be fired when the connection is closed by low-level IO error such as connection reset. 
+    - When the WebSocket is closed **normally**.
+    - Will **NOT** be fired when the connection is closed by low-level IO error such as connection reset.
+    - Fired before `socket_closed`
 - `socket_closed`
-    - When the low-level socket is closed. 
+    - When the low-level socket is closed.
     - Will be fired no matter the WebSocket is closed normally or not.
 
 
 
 ### Cooperate with Tamashii Server
 
-Above example using the [wss://echo.websocket.org](wss://echo.websocket.org) to test your client. You can also use the [Tamashii](https://github.com/tamashii-io/tamashii) server to test your client. Only thing to do is to change the `host` and `port` in the configuration into the one used by your Tamashii server. 
+Above example using the [wss://echo.websocket.org](wss://echo.websocket.org) to test your client. You can also use the [Tamashii](https://github.com/tamashii-io/tamashii) server to test your client. Only thing to do is to change the `host` and `port` in the configuration into the one used by your Tamashii server.
 
 ## Development
 
 To get the source code