Updated README

Author: overint

README.md

@@ -1,2 +1,47 @@
 # php-mailgun-validation
-Validate email address with Mailgun's validation service (Syntax checks, DNS validation, MX validation)
+Validate email address with Mailgun's validation service (Syntax checks, DNS validation, MX validation)  
+You can view Mailgun's blog post about the service here: http://blog.mailgun.com/free-email-validation-api-for-web-forms/
+An API key is required to use this library, it can be obtained for free from mailgun's site after signup:
+https://mailgun.com/app/account/security
+
+The service is free, however fair usage limits do apply (detailed in the post linked above).
+
+You can install this package using composer:
+
+    composer require overint/php-mailgun-validation
+
+Example Use Case
+---------
+
+    <?php
+    require 'vendor\autoload.php';
+    use overint\MailgunValidator;
+    
+    $validator = new MailgunValidator('your-mailgun-public-key');
+    
+    echo var_dump($validator->validate('test@example.com')); //bool(false)
+    echo var_dump($validator->validate('someuser@gmail.com')); //bool(true)
+    echo var_dump($validator->validate('someuser@hotmail.com')); //bool(true)
+    echo var_dump($validator->validate('someuser@aol.com')); //bool(true)
+    echo var_dump($validator->validate('misformed@domain')); //bool(false)
+    echo var_dump($validator->validate('invalid@anonexistingdomain.com')); //bool(false)
+    
+    echo var_dump($validator->validateExtended('someuser@ymail.com'));
+    
+    //      object(stdClass)#2 (4) {
+    //        ["address"]=>
+    //        string(19) "someuser@ymail.com"
+    //        ["did_you_mean"]=>
+    //        NULL
+    //        ["is_valid"]=>
+    //        bool(true)
+    //        ["parts"]=>
+    //        object(stdClass)#4 (3) {
+    //          ["display_name"]=>
+    //          NULL
+    //          ["domain"]=>
+    //          string(10) "mailme.com"
+    //          ["local_part"]=>
+    //          string(8) "someuser"
+    //        }
+    //      }