rework-v-template (#154)

* rework-v-template

Reworked for style and format

* Fixed table headings

* Addressed feedback

Author: ikoevska

content/docs/en/utilities/v-template.md

@@ -1,57 +1,48 @@
 ---
-title: v-template component
-contributors: [rigor789]
+title: v-template
+contributors: [rigor789, ikoevska]
 ---
 
-The `v-template` component is used for defining markup that can be reused as a template.
-
-It is utilized internally by the [ListView Component](/en/docs/elements/components/list-view).
+The `<v-template>` component lets you define markup that you can reuse as a template.
 
 ## Props
 
-| name | type | description |
+| Name | Type | Description |
 |------|------|-------------|
 | `if` | `String` | The condition for using this template.
 | `name` | `String` | The name of the template, auto-generated if omitted.
 
-# Advanced usage
-
-The rest of this document is meant for advanced users implementing their own components that require a template or multiple templates.
+## Basic usage
 
-`v-template` does not render anything when placed into the template, instead it adds a `$templates` property to the parent element or component, which is a [`TemplateBag`](https://github.com/nativescript-vue/nativescript-vue/blob/master/platform/nativescript/runtime/components/v-template.js#L36) instance, and then registers itself as an available template.
+The `<v-template>` component is used internally by the [ListView component](/en/docs/elements/components/list-view) to iterate over its list items.
 
-### TemplateBag
+## Advanced usage
 
-The `TemplateBag` class is useful for registering multiple templates, and provides a function for selecting the correct template based on the item and the conditions provided for each template.
+You can use `v-template` to implement custom components that require a template or multiple templates.
 
-Templates are stored as objects conforming to the [`KeyedTemplate`](https://docs.nativescript.org/api-reference/interfaces/_ui_core_view_.keyedtemplate) interface.
-
-#### The `selectorFn` property
+`v-template` does not render anything when placed in the template. Instead, it adds a `$templates` property to the parent element. This `$templates` property is a [`TemplateBag` instance](https://github.com/nativescript-vue/nativescript-vue/blob/master/platform/nativescript/runtime/components/v-template.js#L36).
 
-The `selectorFn` property returns a function that accepts a single parameter which should be an item whose template should be selected. It will go through all the templates registered in the `TemplateBag` and return the first one where the `if` condition returns a truthy value, and if none of the templates match it will return `default`.
+Next, `v-template` registers itself as an available template in the respective `TemplateBag` instance for the parent element. Any existing `TemplateBag` instance on the parent element is reused.
 
-#### Available Methods
+### The `TemplateBag` class
 
-##### registerTemplate(name: String, condition: String?, scopedFn: Function): void
+The `TemplateBag` class lets you register multiple templates and select the correct template based on the item and the conditions provided for each template.
 
- This method is used to register templates into the `TemplateBag` instance, it is mainly used internally. The `scopedFn` should be a render function of a [scoped slot](https://vuejs.org/v2/guide/components.html#Scoped-Slots)
- 
-##### getConditionFn(condition: String): Function
- 
- This method builds a function that evaluates the given condition. This methods is used internally.
-
-##### getKeyedTemplate(name: String): [KeyedTemplate](https://docs.nativescript.org/api-reference/interfaces/_ui_core_view_.keyedtemplate)
- 
-This method returns the `KeyedTemplate` with the given name.
-
-##### patchTemplate(name: String, context: any, oldVnode: VNode?): View
+Templates are stored as objects conforming to the [`KeyedTemplate`](https://docs.nativescript.org/api-reference/interfaces/_ui_core_view_.keyedtemplate) interface.
 
-This method will patch an existing `VNode` using the provided `context`. If no `oldVnode` is provided, it will create a new View instance for the given template.
+#### The `selectorFn` property
 
-##### getAvailable(): Array<String>
+The `selectorFn` property returns a function that accepts a single parameter. This parameter is the item whose template is selected. 
 
-Returns an array of available `KeyedTemplates` (returns an array of template names)
+The single-parameter function goes through all templates registered in the `TemplateBag` instance and returns the first one where the `if` condition is met. If none of the templates match, returns `default`.
 
-##### getKeyedTemplates(): Array<KeyedTemplate>
+#### Available methods
 
-Returns an array of all the `KeyedTemplates` registered in the `TemplateBag`
+| Method | Description |
+|---|---|
+| `registerTemplate(name: String, condition: String?, scopedFn: Function): void` | _Mainly used internally._<br/>Registers templates in the `TemplateBag` instance.<br/>The `scopedFn` should be a render function of a [scoped slot](https://vuejs.org/v2/guide/components.html#Scoped-Slots) |
+| `getConditionFn(condition: String): Function` | _Used internally._<br/>Builds a function that evaluates the given condition. |
+| `getAvailable(): Array<String>` | Returns an array of available [`KeyedTemplates`](https://docs.nativescript.org/api-reference/interfaces/_ui_core_view_.keyedtemplate). (Returns an array of template names.) |
+| `getKeyedTemplate(name: String): KeyedTemplate` | Returns the [`KeyedTemplate`](https://docs.nativescript.org/api-reference/interfaces/_ui_core_view_.keyedtemplate) with the specified name. |
+| `getKeyedTemplates(): Array<KeyedTemplate>` | Returns an array of all the [`KeyedTemplates`](https://docs.nativescript.org/api-reference/interfaces/_ui_core_view_.keyedtemplate) registered in the `TemplateBag`. |
+| `patchTemplate(name: String, context: any, oldVnode: VNode?): View` | Patches an existing [`VNode`](https://vuejs.org/v2/guide/render-function.html#The-Virtual-DOM) using the provided `context`. If no `oldVnode` is provided, creates a new View instance for the specified template. |