Bootstrap 3.1.1, jQuery 2.1, merged 2-3-2 branch with master (2.3.2 version...

Bootstrap 3.1.1, jQuery 2.1, merged 2-3-2 branch with master (2.3.2 version also working with master branch). Updated documentation and examples. Added FAQ.

README.md

@@ -2,25 +2,22 @@
 
 Bootstrap Multiselect is a JQuery based plugin to provide an intuitive user interface for using select inputs with the multiple attribute present. Instead of a select a bootstrap button will be shown as dropdown menu containing the single options as checkboxes.
 
-**Note:** The option names may have changed due to the latest updates.
-
 Bootstrap 3 port by [Eduard Dudar](https://github.com/edudar).
 
-## Contribute
-
-Every pull request appreciated. Note that the master branch is used for the current bootstrap version. There is an additional branch for bootstrap 2.3.x.
-
-## Documentation and Demos
+## Documentation
 
-Full documentation and demos of different configurations can be found [here](http://davidstutz.github.com/bootstrap-multiselect/).
+Documentation, demonstrations and FAQ: [http://davidstutz.github.com/bootstrap-multiselect/](http://davidstutz.github.com/bootstrap-multiselect/).
 
-**Note**: The demo page is based on JQuery 2 - so for IE 6,7 and 8 the plugin will not work properly, see compatibility below.
+**Note**: The demo page is based on JQuery 2 - so for IE 6,7 and 8 the plugin will not work properly. Nevertheless, the plugin should run as expected using the .x branch of jQuery.
 
-## Compatibility
+## Contribute!
 
-Due to the changes with JQuery 2.x the plugin will not work in IE 6,7 and 8 when using the new JQuery version. So if compatibility for these browsers is needed simply switch to the 1.x version of JQuery. The demo page is running using JQuery 2.
+Every pull request is appreciated. To make it easier for me to merge fixes and new features have a look at the following guidelines:
 
-Details can be found [here](http://blog.jquery.com/2013/04/18/jquery-2-0-released/).
+* Include documentation for new options and features to avoid undocumented features.
+* Add a thorough description to every pull request - so I am able to understand the purpose of the pull request.
+* Have a look at the code as to keep the code as comprehensible and coherent as possible (concerning code style, indentation etc.).
+* Add comments to your code - to help me understand the committed code.
 
 ## License