README improvements

Author: erosb

README.md

@@ -2,7 +2,22 @@ JSON Schema Validator
 =====================
 
 This project is an implementation of the [JSON Schema Core Draft v4](http://json-schema.org/latest/json-schema-core.html) specification.
-It uses the [org.json API](http://www.json.org/java/) for representing JSON data.
+It uses the [org.json API](http://www.json.org/java/) (created by Douglas Crockford) for representing JSON data.
+
+When to use this library?
+-------------------------
+Lets assume that you know what JSON Schema is, and you want to utilize it in a Java application to validate JSON data.
+But - as you may have already discovered - there is also an [other Java implementation](https://github.com/fge/json-schema-validator)
+of the JSON Schema specification. So here are some advices about which one to use:
+ * if you use Jackson to handle JSON in Java code, then fge/json-schema-validator is obviously a better choice, since it
+uses Jackson
+ * if you want to use the [org.json API](http://www.json.org/java/) then this library is the better choice
+ * if you want to use anything else for handling JSON (like GSON or javax.json), then you are in a little trouble, since
+currently there is no schema validation library backed by these libraries. It means that you will have to parse the JSON
+twice: once for the schema validator, and once for your own processing. In a case like that, this library is probably still
+a better choice, since it seems to be [4x faster](https://github.com/erosb/json-schema-perftest) than the Jackson-based fge
+library.
+
 
 Maven installation
 ------------------
@@ -12,7 +27,7 @@ Add the following to your `pom.xml`:
 <dependency>
     <groupId>org.everit.json</groupId>
     <artifactId>org.everit.json.schema</artifactId>
-    <version>1.1.0</version>
+    <version>1.1.1</version>
 </dependency>
 ```