Merge pull request #8 from dbezborodovrp/1.1-readme

Update 1.1 readme.

Author: pie6k

README.md

@@ -1,42 +1,36 @@
-# jquery.initialize
+# jQuery.initialize
 
-Version: 1.0.0, Last updated: 12/14/2016
+Version: 1.1.0, Last updated: 2017-02-06
 
-jquery.initialize plugin is created to help maintaining dynamically created elementes on page.
+jQuery.initialize plugin is created to help maintain dynamically created elements on the
+page.
 
-It has exacly the same syntax like jQuery $elem.each function. 
+## Synopsis
 
-The difference is that jQuery elem .each function is called only once on elements that already exists on page right now. 
+jQuery.initialize will iterate over each element that matches the selector and apply the
+callback function. It will then listen for any changes to the Document Object Model (DOM)
+and apply the callback function to any new elements inserted into to the document that
+match the original selector.
 
-.initialize function will do what .each function does and then it will call function again on new items matching selector automatically just when they will be created by ajax or pretty much anything you can imagine to add new elements to page.
+      $.initialize([selector], [callback])
 
-Simple demo - [click here](http://adampietrasiak.github.io/jquery.initialize/test.html)
+This allows developers to define an initialization callback that is applied whenever a new
+element matching the selector is inserted into the DOM. It works for elements loaded via
+AJAX also.
 
----------------------------
+Simple demo - [click here](http://adampietrasiak.github.io/jQuery.initialize/test.html)
 
-TODO: make it `bower` and `npm` compatible, add advanced performance test.
-
-# Example of use
-  
-  **Initialize has exactly the same syntax as with the .each function**
+## Example of use
 
-	$(".some-element").initialize( function(){
+	$.initialize(".some-element", function() {
 		$(this).css("color", "blue");
 	});
 
-  But now if new element matching .some-element selector will appear on page, it will be instantly initialized. The way new item is added is not important, you dont need to care about any callbacks etc.
+ But now if new element matching .some-element selector will appear on page, it will be instantly initialized. The way new item is added is not important, you dont need to care about any callbacks etc.
 
-	$("<div/>").addClass('some-element').appendTo("body"); //new element will have blue color!
-	
+	$("<div/>").addClass("some-element").appendTo("body"); //new element will have blue color!
 
-Note that plugin needs to know the selector of items you want to initialize. Thats why you need to **call initialize right after you've created jQuery element from selector.**
-
-	$(".some-element").initialize(myFunc); //will work
-	$(".some-element").children().initialize(myFunc); //will NOT work
-
-	
-
-**Support**
+## Browser Compatibility
 
 Plugin is based on **MutationObserver**. It will works on IE9+ (**read note below**) and every modern browser.
 
@@ -45,7 +39,12 @@ Note: To make it work on IE9 and IE10 you'll need to add MutationObserver polyfi
 -----------------
 [Performance test](https://jsfiddle.net/x8vtfxtb/5/) (thanks to **@dbezborodovrp** and **@liuhongbo**)
 
-# Contributors
+## Todo
+
+ - make it `bower` and `npm` compatible, add advanced performance test.
+
+## Contributors
 - Adam Pietrasiak
 - Damien Bezborodov
-- Ninos Ego
+- Ninos Ego
+- Michael Hulse