docs: slight updates to documentation

Author: RonaldJerez

README.md

@@ -84,11 +84,31 @@ See the [token source file](https://github.com/RonaldJerez/vue-input-facade/blob
 <input type="text" v-facade="'##/##/##'" />
 ```
 
-See [demo page](https://ronaldjerez.github.io/vue-input-facade) for more usage examples
+### Migrating existing projects
 
-## Thanks
+If you are migrating an existing project to vue-input-facade from another plugin and dont want to touch the whole codebase.  You may pass options during plugin installation to override the default tokens or directive name.
 
-Thanks to [Marcos Neves](https://vuejs-tips.github.io/) for the vue-the-mask component of which this vue-input-facade was originally forked from.
+```javascript
+import InputFacade from 'vue-input-facade'
+
+// migrating from v-mask
+const options = {
+  // rename the directive from: v-facade to: v-mask
+  name: 'mask',
+
+  // use these tokens instead of the default
+  tokens: {
+    '#': { pattern: /\d/ },
+    'A': { pattern: /[a-z]/i },
+    'N': { pattern: /[0-9a-z]/i },
+    'X': { pattern: /./ }
+  }
+}
+
+Vue.use(InputFacade, options)
+```
+
+See [demo page](https://ronaldjerez.github.io/vue-input-facade) for more usage examples
 
 ## Contribution
 

docs/advanced.md

@@ -6,10 +6,11 @@ If you are migrating an existing project to vue-input-facade from another plugin
 import InputFacade from 'vue-input-facade'
 
 // migrating from v-mask
-// the directive will now be v-mask instead of v-facade
-// and all the tokens will be replaced globally by the following
 const options = {
+  // rename the directive from: v-facade to: v-mask
   name: 'mask',
+
+  // use these tokens instead of the default
   tokens: {
     '#': { pattern: /\d/ },
     'A': { pattern: /[a-z]/i },

docs/directive.md

@@ -1,4 +1,4 @@
-For times when you cannot use the component, you may use the directive instead. The directive has all the same features as the component, however the interface may not be as straight forward as using a component.
+For times when you cannot use the component, you may use the directive instead. The directive has all the same features as the component, however the interface may not be as straight forward as using a component.  The `prefill` and `short` features may passed in to the directive as modifiers.
 
 ### Basic usage
 
@@ -16,6 +16,8 @@ let value = '12A789MM'
 
 You have access to the unmasked value via the input event.  The `unmaskedValue` property can be found as part of the `target` property of the input event.
 
+> Note: Some 3rd party components may not pass the `event` parameter when emitting input, such is the case with vuetify's v-text-input.  In this case you can listen to the native event so you can still access the unmasked value.  ex: `v-on:input.native="handler"`.
+
 ```js
 let event = ''