From 0e2988444f7d172b39da7a84a00c052bcbba9999 Mon Sep 17 00:00:00 2001
From: Andrew Boyd <andrew@wearebraid.com>
Date: Sun, 8 Mar 2020 10:20:02 -0400
Subject: [PATCH] adds gifs to readme and updates some language

---
 README.md | 31 ++++++++++++++++++++-----------
 1 file changed, 20 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index 3c9f20e..02e2bd4 100644
--- a/README.md
+++ b/README.md
@@ -14,10 +14,16 @@
 ### What is Vue Formulate?
 
 Vue Formulate is the easiest way to build forms using Vue. Key features include
-form and field validation, file uploads, form generation and a single-element
-fields with labels, help text, error messages, placeholders and lots more.
+form and field validation, file uploads, form generation, single-element inputs that support labels, help text, error messages, placeholders and more, and [comprehensive documentation](https://vueformulate.com) for use within your own projects.
 
-The syntax is what developers would expect:
+
+:-------------------------:|:-------------------------:
+![uploads](https://assets.wearebraid.com/vue-formulate/formulate-uploads.gif)  |  ![form demo](https://assets.wearebraid.com/vue-formulate/formulate-form.gif)
+
+
+### How is Vue Formulate used?
+
+The syntax is what developers would expect. To create an input you use the `FormulateInput` element and provide it with a few props:
 
 ```vue
 <FormulateInput
@@ -30,15 +36,18 @@ The syntax is what developers would expect:
 />
 ```
 
+Collecting multiple `FormulateInput` elements within a single `FormulateForm` element (even deeply nested) allows you to `v-model` your entire form.
+
+### Vue Formulate lets you:
 ✓ Create any input element with a single component<br>
-✓ Supports Vue `v-model` [binding](https://vueformulate.com/guide/#model-binding)<br>
+✓ Use `v-model` [binding](https://vueformulate.com/guide/#model-binding) on fields and entire forms<br>
 ✓ [Re-populate an entire form](https://vueformulate.com//guide/forms/#setting-initial-values) from a single object<br>
 ✓ [Generate a form](https://vueformulate.com//guide/forms/#generating-forms) using json<br>
-✓ Easy to add field labels<br>
-✓ Easy to add help text<br>
-✓ Easy to add [form validation](https://vueformulate.com//guide/validation)<br>
-✓ Easy to add [custom validation](https://vueformulate.com//guide/validation/#custom-validation-rules) rules<br>
-✓ Easy to modify [validation messages](https://vueformulate.com//guide/validation/#customize-validation-messages)<br>
-✓ Easy to add [custom inputs](https://vueformulate.com//guide/custom-inputs)
+✓ Easily add field labels<br>
+✓ Easily add help text<br>
+✓ Easily add [form validation](https://vueformulate.com//guide/validation)<br>
+✓ Easily add [custom validation](https://vueformulate.com//guide/validation/#custom-validation-rules) rules<br>
+✓ Easily create custom [validation messages](https://vueformulate.com//guide/validation/#customize-validation-messages)<br>
+✓ Easily create [custom inputs](https://vueformulate.com//guide/custom-inputs)
 
-There's a lot more available to read at the [documentation website](https://vueformulate.com).
+There's a lot more available to read at the comprehensive [documentation website](https://vueformulate.com).