README.md in excon-addressable-0.1.1 vs README.md in excon-addressable-0.2.0

@@ -1,8 +1,9 @@
 # Excon::Addressable [![wercker status](https://app.wercker.com/status/3868c162aa140566b830f517c45d528a/s/master "wercker status")](https://app.wercker.com/project/bykey/3868c162aa140566b830f517c45d528a)
 
-Sets [Addressable][] as the default URI parser. Supports parsing [templated uris][].
+Sets [Addressable][addressable] as the default URI parser. Supports parsing
+[templated uris][].
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
@@ -10,24 +11,39 @@
 gem 'excon-addressable'
 ```
 
 And then execute:
 
-    $ bundle
+```shell
+bundle
+```
 
 Or install it yourself as:
 
-    $ gem install excon-addressable
+```shell
+gem install excon-addressable
+```
 
 ## Usage
 
+Be sure to add `Excon::Addressable::Middleware` to the top of the middleware
+stack, so that the variables get expanded as early as possible. This prevents
+other middleware from choking on non-valid URIs.
+
 ```ruby
+Excon.defaults[:middlewares].unshift(Excon::Addressable::Middleware)
+```
+
+Then simply provide a templated variable, and the values with which to expand
+the template:
+
+```ruby
 conn = Excon.new('http://www.example.com/{uid}', expand: { uid: 'hello' })
 conn.request.path # => '/hello'
 ```
 
 ## License
 
 The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
 
-[Addressable]: https://github.com/sporkmonger/addressable
+[addressable]: https://github.com/sporkmonger/addressable
 [templated uris]: https://github.com/sporkmonger/addressable#uri-templates