update readme

README.md

@@ -4,7 +4,7 @@ Laravel VAT
 <a href="https://travis-ci.org/dannyvankooten/laravel-vat"><img src="https://img.shields.io/travis/dannyvankooten/laravel-vat/master.svg?style=flat-square" alt="Build Status"></img></a>
 <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square" alt="Software License"></img></a>
 
-laravel-vat is a Laravel package that contains the Laravel-related wiring code for [vat.php](https://github.com/dannyvankooten/vat.php), helping you deal with VAT for businesses based in Europe.
+laravel-vat is a package that contains the Laravel related wiring code for [vat.php](https://github.com/dannyvankooten/vat.php), helping you deal with VAT legislation for businesses based in Europe.
 
 - Fetch (historical) VAT rates for any European member state using [jsonvat.com](https://github.com/adamcooke/vat-rates)
 - Validate VAT numbers (by format, [existence](http://ec.europa.eu/taxation_customs/vies/) or both)
@@ -25,7 +25,12 @@ The package will automatically register itself.
 
 ## Usage
 
-If you registered the facades then using an instance of the classes is as easy as this:
+Check out the [vat.php README](https://github.com/dannyvankooten/vat.php) for general usage of this package.
+
+
+#### Facades
+
+Using facades, retrieving an instance of the classes provided by vat.php is easy:
 
 ```php
 use DvK\Laravel\Vat\Facades\Rates;
@@ -51,6 +56,52 @@ Countries::ip('8.8.8.8'); // US
 
 By default, VAT rates are cached for 24 hours using the default cache driver.
 
+
+#### Validation
+
+The package registers two new validation rules.
+
+**vat_number**
+
+The field under validation must be a valid and existing VAT number.
+
+**country_code**
+
+The field under validation must be a valid ISO-3316 alpha-2 country code.
+
+```php
+use Illuminate\Http\Request;
+
+class Controller {
+
+    public function foo(Request $request) 
+    {
+        $request->validate([
+            'vat_number_field' => ['vat_number'],
+            'country_code_field' => [ 'country_code' ],
+        ]);
+    }
+}
+```
+
+Alternatively, you can also use the `Rule` objects directly.
+
+```php
+use Illuminate\Http\Request;
+use DvK\Laravel\Vat\Rules;
+
+class Controller {
+
+    public function foo(Request $request) 
+    {
+        $request->validate([
+            'vat_number_field' => [ new Rules\VatNumber() ],
+            'country_code_field' => [ new Rules\Country() ],
+        ]);
+    }
+}
+```
+
 ## License
 
 [MIT licensed](LICENSE).