Updated comments

theironcook · theironcook · commit dbf1ba2b398a · 2012-05-29T12:33:42.000-06:00
diff --git a/README.md b/README.md
@@ -1,21 +1,16 @@
 Special thanks to [Derick Bailey](http://lostechies.com/derickbailey) for creating predecessor to this plugin.
 I've been able to reuse unit tests he created for his [Backbone.ModelBinding](https://github.com/derickbailey/backbone.modelbinding) plugin.
 
-### Availability
-You can download the zip/tarball as normal and include it with your other JS assets, but you can now alternatively link to it on [CDNJS](http://www.cdnjs.com/), the free to use, community maintained CDN.
-
-To do this, just drop a reference to the minified version of the plugin into your document's `<head>` as follows, replacing the version number with whatever the latest one is:
-````
-<script type="text/javascript" src="http://cdnjs.cloudflare.com/ajax/libs/backbone.modelbinder/0.1.3/Backbone.ModelBinder-min.js"></script>
-````
 
 ### Rationale
 Backbone is a great platform for writing client side applications but I've found that as views grow in complexity, synchronizing my models and views can be a pain.
 I've spent the past few months trying to use existing view-model binding libraries that others were kind enough to create and share with the world.
 Unfortunately in the majority of my backbone application I wasn't able to leverage the existing view-model binding libraries due to various limitations.
 
 I created a new `Backbone.ModelBinder` class that I have leveraged in the majority of a large client side application.
-The ModelBinder class helped me remove a lot of cluttered boilerplate code that existed to synchronize my models and views.  Hopefully you'll find it useful too.
+The ModelBinder class helped me remove a lot of cluttered boilerplate code that existed to synchronize my models and views.
+As my application became more asynchronous, the ModelBinder saves me from a lot of pain by automatically displaying model attributes in the view as they are asynchronously loaded.
+Hopefully you'll find the ModelBinder useful too.
 
 The `Backbone.ModelBinder` class:
 
@@ -43,13 +38,13 @@ SomeView = Backbone.View.extend({
     },
 
     render: function() {
-        $(this.el).html(this.template(this.model.toJSON()));
+        this.$el.html(this.template(this.model.toJSON()));
         return this;
     }
 });
 ````
 
-While the style above technically works just fine it can be more efficient - especially for larger client applications that are not frequently refreshed.
+While the style above technically works just fine it can be more efficient by using the ModelBinder - especially for larger client applications that are not frequently refreshed.
 
 If render is called multiple times, the previously created html elements are just thrown away.
 Converting the model to json is also an unnecessary conversion.
@@ -64,6 +59,17 @@ The ModelBinder eliminates both of these inefficiencies.
 
 <br>
 I've posted some [examples](https://github.com/theironcook/Backbone.ModelBinder/wiki/Examples) of how to use the ModelBinder but I'd recommend reading the docs first.
+The examples don't show best practices but just show how you can make things work with the ModelBinder.
+
+<br>
+### Availability
+You can download the zip/tarball as normal and include it with your other JS assets, but you can now alternatively link to it on [CDNJS](http://www.cdnjs.com/), the free to use, community maintained CDN.
+
+To do this, just drop a reference to the minified version of the plugin into your document's `<head>` as follows, replacing the version number with whatever the latest one is:
+````
+<script type="text/javascript" src="http://cdnjs.cloudflare.com/ajax/libs/backbone.modelbinder/0.1.3/Backbone.ModelBinder-min.js"></script>
+````
+
 
 <br>
 ##Defining Binding Scope with jQuery##
