Proof-reading and re-formatting content (#150)

* Fixed typos in introduction

* Fixed product name in Quick Start

* Fixed phrasing in Installation guide

* Proofreading and formatting for Templates

* Proofreading and re-formatting of NS plugins

* Removed code formatting from section title

* Proof-reading and re-formatting

* Updated content

* Updated template descriptions

* Update 4-templates.md

* Switched from headings to bold formatting

Author: ikoevska

content/docs/en/getting-started/1-quick-start.md

@@ -3,7 +3,7 @@ title: Quick Start
 contributors: [rigor789, eddyverbruggen, damain, ikoevska]
 ---
 
-If you don't want the hassle of installing and configuring your system before you can have a taste of NativeScript + Vue.js development, the [NativeScript Playground](/en/docs/getting-started/playground-tutorial) has you covered.
+If you don't want the hassle of installing and configuring your system before you can have a taste of NativeScript-Vue, the [NativeScript Playground](/en/docs/getting-started/playground-tutorial) has you covered.
 
 But if [you already have your system ready for native development](/en/docs/getting-started/installation), you can start by using a template:
 
@@ -22,4 +22,4 @@ $ npm run watch:<platform>
 
 where platform is `ios` or `android`.
 
-For more information about the available templates, see the [templates documentation](/en/docs/getting-started/templates).
+For more information about the available templates, see the [templates documentation](/en/docs/getting-started/templates).

content/docs/en/getting-started/3-installation.md

@@ -15,7 +15,7 @@ To use NativeScript-Vue, you need to set up your system to compile your apps.
 
 ### Node.js
 
-Download and install the latest _LTS_ version of Node.js from [https://nodejs.org/](https://nodejs.org/). Restart your terminal and verify the installation was successful with the command `node --version`.
+Download and install the latest _LTS_ version of Node.js from [https://nodejs.org/](https://nodejs.org/). Restart your terminal and verify the installation was successful by running `node --version`.
 
 ### NativeScript CLI
 
@@ -25,23 +25,22 @@ To install the NativeScript CLI, open your terminal and run:
 $ npm install -g nativescript
 ```
 
-You can verify the installation was successful by running `tns` in your terminal. You should see a list of all the available commands.
-
+Verify the installation was successful by running `tns` in your terminal. You should see a list of the available commands.
 
 ### Windows
 
-System requirements and setup instructions for the Android SDK on Windows:
+Check the system requirements and follow the setup instructions for the Android SDK on Windows:
 
 [Advanced setup: Windows](https://docs.nativescript.org/start/ns-setup-win)
 
 ### macOS
 
-System requirements and setup instructions for Xcode and the Android SDK for your Mac:
+Check the system requirements and follow the setup instructions for Xcode and the Android SDK on macOS:
 
 [Advanced setup: macOS](https://docs.nativescript.org/start/ns-setup-os-x)
 
 ### Linux
 
-System requirements and setup instructions for the Android SDK on Linux:
+Check the system requirements and follow the setup instructions for the Android SDK on Linux:
 
-[Advanced setup: Linux](https://docs.nativescript.org/start/ns-setup-linux)
+[Advanced setup: Linux](https://docs.nativescript.org/start/ns-setup-linux)

content/docs/en/getting-started/4-templates.md

@@ -1,13 +1,12 @@
 ---
 title: Templates
-contributors: [rigor789, tralves, jlooper, lewebsimple]
+contributors: [rigor789, tralves, jlooper, lewebsimple, ikoevska]
 outdated: false
 ---
 
-This page serves as an overview of the currently supported templates that you can use to get started with NativeScript-Vue.
-It is also assumed that you have [set up your system for NativeScript development](/en/docs/getting-started/installation).
+This page provides an overview of the templates that you can use to develop apps with NativeScript-Vue. The list is updated as new templates come up or old templates become deprecated.
 
-> This list will be updated as new templates come up, or old templates get deprecated.
+> **NOTE:** To use any of the listed templates, you need to [set your system up for NativeScript development](/en/docs/getting-started/installation).
 
 **Currently supported templates:**
 
@@ -20,17 +19,22 @@ It is also assumed that you have [set up your system for NativeScript developmen
 
 ## nativescript-vue/vue-cli-template
 
-Project link: [https://github.com/nativescript-vue/vue-cli-template](https://github.com/nativescript-vue/vue-cli-template)
+**Project link:** [https://github.com/nativescript-vue/vue-cli-template](https://github.com/nativescript-vue/vue-cli-template)
+
+**Features**
 
-**Features:**
 * `.vue` single file components
-* Vuex — state management (opt-in)
-* VueRouter — routing (opt-in) — **experimental!**
+* Vuex—state management (opt-in)
+* Vue Router—routing (opt-in)—**experimental**
 * NativeScript themes
 
-You can use [Vue CLI](https://github.com/vuejs/vue-cli) to bootstrap your NativeScript-Vue app. Out of the box, this template provides support for [Vuex](https://vuex.vuejs.org/en/), the [Vue Router](https://github.com/vuejs/vue-router), and [NativeScript themes](https://docs.nativescript.org/ui/theme). Originally built by [Pascal Martineau](https://github.com/lewebsimple/), this template is now officially supported for NativeScript-Vue development.
+Use this template to develop your app from the [Vue CLI](https://github.com/vuejs/vue-cli) and design it around `.vue` file components. Out-of-the-box, the template also provides advanced Vue functionality ([Vuex](https://vuex.vuejs.org/en/) and [Vue Router](https://github.com/vuejs/vue-router)) and support for [NativeScript themes](https://docs.nativescript.org/ui/theme).
+
+Functionality-wise, the template is a spin-off of the basic template for NativeScript development and implements a simple button-controlled counter.
+
+Originally built by [Pascal Martineau](https://github.com/lewebsimple/), this template is now officially supported for NativeScript-Vue.
 
-**Usage:**
+**Usage**
 
 ```shell
 $ npm install -g @vue/cli @vue/cli-init
@@ -44,15 +48,18 @@ $ npm run watch:ios
 
 ## nativescript-vue/nativescript-vue-template
 
-Project link: [https://github.com/nativescript-vue/nativescript-vue-template](https://github.com/nativescript-vue/nativescript-vue-template)
+**Project link:** [https://github.com/nativescript-vue/nativescript-vue-template](https://github.com/nativescript-vue/nativescript-vue-template)
 
-**Features:**
-* Pure JS — no `.vue` files
+**Features**
+
+* Pure JavaScript—no `.vue` files
 * NativeScript themes
 
-This template is the simplest way you can develop your app with NativeScript-Vue. It does not require an extra build step, because the components / application is written in pure `.js` files. 
+Use this template to develop your app from the [NativeScript CLI](https://github.com/NativeScript/nativescript-cli), using only JavaScript.
+
+Functionality-wise, the template is a spin-off of the basic template for NativeScript development and implements a simple button-controlled counter.
 
-**Usage:**
+**Usage**
 
 ```shell
 $ tns create <project-name> --template nativescript-vue-template

content/docs/en/getting-started/5-nativescript-plugins.md

@@ -1,33 +1,41 @@
 ---
 title: Using NativeScript Plugins
-contributors: [EddyVerbruggen, naderio, rigor789]
+contributors: [EddyVerbruggen, naderio, rigor789, ikoevska]
 ---
 
-Plugins work as in any other NativeScript app, but you may wonder how *UI* plugins would work with Vue.
+Plugins work as in [any other NativeScript app](https://docs.nativescript.org/plugins/plugins), but you may wonder how *UI* plugins work with Vue.
 
-UI plugins work almost identically to how you'd use a NativeScript UI plugin in an Angular app. For instance consider this example usage of [nativescript-gradient](https://github.com/EddyVerbruggen/nativescript-gradient) which is used in the [listview sample](https://github.com/rigor789/nativescript-vue/tree/master/samples/app/app-with-list-view.js):
+UI plugins work almost identically to how you'd [use a NativeScript UI plugin in an Angular app](https://docs.nativescript.org/angular/plugins/plugins). 
 
-Install the plugin using the NativeScript CLI:
+## Sample use: nativescript-gradient
+
+Let's review how you can use [nativescript-gradient](https://github.com/EddyVerbruggen/nativescript-gradient). You can also check its use in the [listview sample](https://github.com/rigor789/nativescript-vue/tree/master/samples/app/app-with-list-view.js).
+
+### Install the plugin using the NativeScript CLI
+
+After you have [set up your system for NativeScript development](/en/docs/getting-started/installation), run the following command:
 
 ```shell
 $ npm install --save nativescript-gradient
 ```
 
-**NOTE:** If you are using the [vue-cli-template](/en/docs/getting-started/templates/#nativescript-vuevue-cli-template) you may have to run the following:
+> **NOTE:** If you are using the [vue-cli-template](/en/docs/getting-started/templates/#nativescript-vuevue-cli-template), you may have to run the following:
 
 ```shell
 $ npm run clean
 ```
 
-Open your app entry file and add the following to the top:
+### Register the plugin in your app
+
+Open your app entry file (llikely `app.js` or `main.js`) and add the following line at the top:
 
-```js
+```JavaScript
 Vue.registerElement('Gradient', () => require('nativescript-gradient').Gradient)
 ```
 
-Then in your template, you can use the newly registered element:
+### Use the plugin in your app
 
-```html
+```HTML
 <Gradient direction="to right" colors="#FF0077, red, #FF00FF">
   <Label text="Best gradient." horizontalAlignment="center"
          style="color: white; padding: 20" />

content/docs/en/getting-started/6-vue-plugins.md

@@ -1,57 +1,63 @@
 ---
 title: Using Vue Plugins
-contributors: [jlooper]
+contributors: [jlooper, ikoevska]
 ---
 
-## vue-router
+This page provides an overview of the currently supported Vue plugins that work with NativeScript-Vue.
 
-VueRouter is a Vue plugin to handle URL based routing.
-An experimental integration with vue-router has been added to Nativescript-Vue.
+* [Vue Router](#vue-router)
+* [Vuex](#vuex)
 
-Keep in mind, the routing strategy on mobile is not exactly same as URL and History API used in a browser.
+## Vue Router
 
-Router links, as you are familiar in Vue like the following **will not work** in NativeScript
+> Currently, integration with Vue Router is **experimental**. For more information, see [the Vue Router page](/en/docs/routing/vue-router/).
 
-```html
-<!-- does not work -->
-<router-link to="/foo">Go to Foo</router-link>
-```
+### Install and require the plugin
+
+For detailed information about how to install the plugin and make it available in your NativeScript-Vue app, see [the Vue Router page](/en/docs/routing/vue-router/).
+
+### Usage notes
+
+The routing strategy on mobile is different than the routing strategy in the browser and the familiar Vue format of router links does not work with NativeScript-Vue.
 
-Instead we have to change to a new route using the `route.push` method. For example when using a button we can use the `tap` event to change the route:
+Instead, you need to **change to a new route using the `route.push` method**. The following example shows how to use the `tap` event to change the route.
 
-```html
+```HTML
 <Button class="btn btn-primary" @tap="$router.push('/counter')">Counter</Button>
-```
+``` 
 
-For a more in depth documentation about the router [go to the VueRouter page](/en/docs/routing/vue-router/).
+For detailed information about how to use the plugin in your NativeScript-Vue app, see [the Vue Router page](/en/docs/routing/vue-router/).
 
 ## Vuex
 
-Vuex is Vue.js's state management pattern and library. It serves as a store for all the components in an application and implements rules to ensure that state is mutated in a predictable fashion. Vuex can be used in NativeScript apps; for an example, see the [NativeScript Groceries Vue sample](https://github.com/tralves/groceries-ns-vue). 
+Vuex is a state management pattern and library. It serves as a store for all the components in an app and implements rules to ensure that state is mutated in a predictable fashion. 
 
-### Install
+### Install the plugin
 
 Install Vuex as you would normally in your Vue.js app. With npm, for example:
 
 ```shell
 $ npm install --save vuex
 ```
 
-The most recent version of Vuex will be added to your package.json file.
+The most recent version of Vuex will be added to your `package.json`.
 
-### Import
+### Import the plugin
 
-In your app's `main.js` file, import Vuex at the top:
+Open your app entry file (llikely `app.js` or `main.js`) and add the following line at the top:
 
 ```js
 import Vuex from 'vuex'
 Vue.use(Vuex)
 ```
-Now you can use Vuex in the app similar to how you would use it in a standard Vue app for the web to manage your app's state.
 
-### Create a Store
+Now you can use Vuex to manage the state of your mobile app, similar to how you would use it in a standard Vue web app.
+
+### Usage: Create a store
 
-Above your creation of a new Vue instance, or in a separate folder (for example `/store` in your app folder), create a new constant to store your state. This is where you will invoke Vuex API calls. A simple store constant would include the state of a counter whose state you control throughout your app by means of tracking its mutations:
+You need to create a new constant to store your state and invoke Vuex API calls. You can do that in the app entry file after the creation of the Vue instance or in a separate folder (for example, `/store`).
+
+In the following example, a simple store constant includes the state of a counter and tracks its mutations:
 
 ```js
 const store = new Vuex.Store({
@@ -65,9 +71,9 @@ const store = new Vuex.Store({
 })
 ```
 
-### Use the Store
+### Usage: Use the store
 
-Now you can manage state by calling the store you just created. In the example below, the app tracks the count value as you press a '+' or '-' button. Note that you don't manipulate the state itself, but rather call mutations to increment and decrement its value.
+Now you can manage state by calling the store you just created. In the following example, the app tracks the count value as you press a '+' or '-' button. Note that you don't manipulate the state itself, but call mutations to increment and decrement its value.
 
 ```js
 new Vue({
@@ -100,4 +106,6 @@ new Vue({
 }).$start()
 ```
 
-More information about Vuex and how to manage state can be found in [the Vuex documentation](https://vuex.vuejs.org/en/core-concepts.html). A good architecture to manage the various elements of Vuex can be found in the Groceries app in the [`/store` folder](https://github.com/tralves/groceries-ns-vue/tree/master/src/store/).
+For more information about Vuex, see [the Vuex documentation](https://vuex.vuejs.org/en/core-concepts.html). 
+
+For more examples about how to manage the elements of Vuex, explore the [`/store` folder](https://github.com/tralves/groceries-ns-vue/tree/master/src/store/) of the NativeScript-Vue Groceries sample.

content/docs/en/introduction.md

@@ -5,7 +5,7 @@ contributors: [rigor789, tjvantoll]
 
 ## What is [NativeScript](https://www.nativescript.org/)?
 
-NativeScript is an open source framework for building truly native mobile application using JavaScript.
+NativeScript is an open source framework for building truly native mobile applications using JavaScript.
 
 ## What is [Vue.js](https://vuejs.org/)?
 
@@ -21,7 +21,7 @@ If you have used Vue.js before you will feel right at home with NativeScript-Vue
 
 There are many options to build mobile apps. Here are some situations where we think NativeScript-Vue is a great fit.
 
-* **You need a truly native iOS and Android app**: NativeScript builds your apps using native user interface components on iOS and Android. The apps you build are not web based, and therefore are not subject to the limitations inherent in WebView-based application frameworks. NativeScript also provides [an extensive collection of plugins](http://market.nativescript.org/) to tie into native device features. So if you need to tie into an iOS or Android API or feature as part of your app, you can do that with NativeScript.
+* **You need a truly native iOS and Android app**: NativeScript builds your apps using native user interface components on iOS and Android. The apps you build are not web-based, and therefore are not subject to the limitations inherent in WebView-based application frameworks. NativeScript also provides [an extensive collection of plugins](http://market.nativescript.org/) to tie into native device features. So if you need to tie into an iOS or Android API or feature as part of your app, you can do that with NativeScript.
 * **You like JavaScript**: With NativeScript you write your mobile applications in JavaScript — not Objective-C, not Swift, and not Java. If you like JavaScript, you’ll love writing native iOS and Android apps with the same language you use in your Web and/or Node apps.
 * **You like Vue**: Vue is known for its simple approach to the view layer. If you like building web apps with Vue, you’ll be right at home with NativeScript-Vue, as you’ll be using the same syntax for handling common tasks like data binding and event handling.
 
@@ -40,7 +40,7 @@ NativeScript-Vue is an open source project and contributions are very much encou
 
 ## How stable is this project?
 
-NativeScript-Vue is relatively feature complete. At this time we’re focusing on two things:
+NativeScript-Vue is relatively feature-complete. At this time we’re focusing on two things:
 
 * **Documentation**: Not everything you can do in NativeScript-Vue is documented on this site. We’re actively adding samples and use cases to this site, and contributions are welcome.
 * **Sample apps**: We’re looking for people to put this plugin through its paces and send feedback our way. If you’re interested, join the [NativeScript Community Slack](https://developer.telerik.com/wp-login.php?action=slack-invitation) and let us know in the #vue channel.