message: docs: added an overview section
diff: ---
  -title: Getting Started
  +title: Overview
  description: Getting started with VeeValidate
  meta:
  - name: og:title
  @@ -8,23 +8,35 @@ meta:
  content: Getting started with VeeValidate
  ---
  -# Getting started
  +# Overview
  -## Installation
  +Form validation is one of the most difficult subjects in frontend, not only you have to deal with ensuring correct values are submitted, you must also make sure to provide a suitable UX for your users. And we also have to deal with accessability and making sure our forms are inclusive and usable for all types of our users, doing form validation by hand is painful and is a lot of work and you won't probably cover localization and cross-field validation! **The time you spend working on a custom form validation solution is better spent building your application logic**.
  -### yarn
  +Most validation libraries will save you a lot of time, but `vee-validate` tackles the major pain points of form validation and addresses them in the most flexible way possible:
  +
  +- Ability to craft complicated UX for your users.
  +- Utilities to enhance your forms accessability and styling.
  +- Localization is built-in the core.
  +- Many validations are available and pre-translated out of the box.
  +- Cross Field validation with advanced features.
  +
  +## Getting Started
  +
  +### Installation
  +
  +#### yarn
  ```bash
  yarn add vee-validate
  ```
  -### npm
  +#### npm
  ```bash
  npm install vee-validate --save
  ```
  -### CDN
  +#### CDN
  ```html
  <!-- jsdelivr cdn -->
  @@ -34,9 +46,9 @@ npm install vee-validate --save
  <script src="https://unpkg.com/vee-validate@latest"></script>
  ```
  -## Usage
  +### Usage
  -### via script tag
  +#### via script tag
  include the script directly
  @@ -55,7 +67,7 @@ include the script directly
  </script>
  ```
  -### ES6+
  +#### ES6+
  ```js
  import Vue from 'vue';
  @@ -75,7 +87,7 @@ Vue.component('ValidationProvider', ValidationProvider);
  All Examples from now on will use the ES2015 syntax, make sure to brush up on ES2015 if you haven't already.
  :::
  -## Basic Example
  +### Basic Example
  VeeValidate exposes a `ValidationProvider` component that allows you to validate your fields. To validate, wrap your field with a `validation-provider` component:
  @@ -103,7 +115,7 @@ The `rules` prop passed to the `ValidationProvider` is the validation rules that
  To display error messages, the `ValidationProvider` exposes `errors` array through [scoped slots](https://vuejs.org/v2/guide/components-slots.html#Scoped-Slots), this array contains error messages related to that field.
  -### Demo
  +#### Demo
  Here is the above example in action, enter `example` to pass validation:
  