docs(multiselect): various fixes

Author: pepinho24

controls/multiselect/client-side-programming/overview.md

@@ -44,6 +44,7 @@ In addition to using the Kendo method directly, you can also use their wrappers
 | **dispose** |none|none|Disposes the MultiSelect client-side object (calls its underlying Kendo widget's [destroy](https://docs.telerik.com/kendo-ui/api/javascript/ui/multiselect/methods/destroy) method). Once you call it, you will not be able to use the widget or control.|
 | **focus** |none|none|Focuses the input.|
 | **get_enabled** |none|Boolean|Returns whether the control is enabled.|
+| **get_filter** |none|Telerik.Web.UI.RadMultiSelectFilter|Returns the filter type of the control. The possible values are *Telerik.Web.UI.RadMultiSelectFilter.StartsWith* = 0, *Telerik.Web.UI.RadMultiSelectFilter.Contains* = 1 and *Telerik.Web.UI.RadMultiSelectFilter.EndsWith* = 2.|
 | **get_inputElement** |none|DOM object|Returns a reference to the input element.|
 | **get_items** | none | Array | Returns an array of the DOM `<li>` elements, which correspond to the data items from the Kendo UI DataSource of the widget. |
 | **get_kendoWidget** |none|object|Returns a reference to the underlying Kendo MultiSelect widget.|
@@ -57,6 +58,7 @@ In addition to using the Kendo method directly, you can also use their wrappers
 | **refresh** |none|none|Refresh the popup by rendering all items again.|
 | **search** |string|none|Searches the data source for the provided value and displays any matches as suggestions.|
 | **set_enabled** |Boolean|none| Enables or disables the widget if you pass `true` or `false` respectively.|
+| **set_enabled** |Telerik.Web.UI.RadMultiSelectFilter|none| Sets the new filter type of the control. The possible values are *Telerik.Web.UI.RadMultiSelectFilter.StartsWith* = 0, *Telerik.Web.UI.RadMultiSelectFilter.Contains* = 1 and *Telerik.Web.UI.RadMultiSelectFilter.EndsWith* = 2.|
 | **set_readOnly** |Boolean|none|Sets whether the input is readonly and typing is disabled.|
 | **set_value** |string|none|Sets the value. See the underlying [value](https://docs.telerik.com/kendo-ui/api/javascript/ui/multiselect/configuration/value) method for more details on its behavior.|
 | **toggle** |none|none|Opens or closes the dropdown depending on its current state.|

controls/multiselect/data-binding/client-side.md

@@ -16,14 +16,15 @@ position: 1
 There are two ways to bind to data on the client:
 
 - [Client-Side Data Binding](#client-side-data-binding)
-	- [WebServiceSettings](#webservicesettings)
-	- [JavaScript Object at Runtime](#javascript-object-at-runtime)
-	- [See Also](#see-also)
+  - [WebServiceSettings](#webservicesettings)
+  - [JavaScript Object at Runtime](#javascript-object-at-runtime)
+  - [See Also](#see-also)
 
 ## WebServiceSettings
 
 Under the covers, a [Kendo UI DataSource](https://docs.telerik.com/kendo-ui/framework/datasource/overview) will be instantiated and it will perform requests to the denoted service with the settings defined in the `WebServiceSettings` tag.
-RadMultiSelect has an embeded RadClientDataSource control, which can be a configured through the `WebServiceClientDatasource` composite property. The widget only shows data and so only the **Select** settings and `ServiceType` are used. The rest of the settings (for Insert, Update, Delete) will not be used and are inherited from a base class.
+
+RadMultiSelect has an embeded RadClientDataSource control, which can be a configured through the `WebServiceClientDatasource` composite property. The widget is designed to show data and mainly the **Select** settings and `ServiceType` are used. The rest of the settings (for Insert, Update, Delete) are inherited from the RadClientDataSource class and can be used in custom implementations.
 
 >caption Example 1: Setting WebServiceClientDataSource and WebServiceSettings to bind to a web service
 
@@ -144,7 +145,7 @@ public class Book
 
 ## JavaScript Object at Runtime
 
-You can use the `set_dataSource()` [client-side method]({%slug multicolumncombobox/client-side-programming/overview%}) of the RadMultiSelect object to provide it with a new client-side data source. You do not have to provide a server data source or a web service for this to work, you only need to define the proper configuration (columns and fields) to match the data you will pass to the widget.
+You can use the `setDataSource()` of the RadMultiSelect's underlying Kendo UI widget to provide it with a new client-side data source. You do not have to provide a server data source or a web service for this to work, you only need to define the proper configuration to match the data you will pass to the widget.
 
 >caption Example 3: Binding to a JavaScript array
 

controls/multiselect/data-binding/server-side.md

@@ -10,11 +10,11 @@ position: 0
 
 # Server-Side Data Binding
 
-**RadMultiSelect** can be bound to standard server data sources like `List<T>`, `SqlDataSource` or a `DataTable`. The data from the server data source creates MultiSelect items which are serialized as a JSON literal to the client-side. It is parsed on the client-side as the **RadMultiSelect** is a wrapper over the Kendo UI for jQuery widget which are entirely client-side. 
+**RadMultiSelect** can be bound to standard server data sources like `List<T>`, `SqlDataSource` or a `DataTable`. The data from the server data source creates MultiSelect items which are serialized and sent to the client-side as a JSON object. It is parsed on the client-side and passed to the underlying Kendo UI MultiSelect which is an entirely client-side widget. 
 
-The fields that you would like to have available on the client-side should be passed to the `DataKeyNames` property, comma-separated. Also, you can add additional data to the items via the Attributes collection which will be serialized and available on the client-side.
+The additional fields you would like to access on the client-side should be passed to the `DataKeyNames` property, as a comma-separated string. Also, you can add custom data to the items via the `Attributes` collection which will be serialized and available on the client-side.
 
->note The DataTextField, DataValueField and the Fields declared in **RadMultiSelect** are added by default to the DataKeyNames, so it is not necessary to add them explicitly.
+>note The `DataTextField` and `DataValueField` are available by default on the client-side and there is no need to add them explicitly to the `DataKeyNames` collection.
 >
 
 >caption Example 1: Declare items in the Markup
@@ -63,7 +63,7 @@ End Sub
 ````
 
 
->caption Example 3: Bind to an `SqlDataSource`
+>caption Example 3: Bind to a `SqlDataSource`
 
 ````ASP.NET
 <telerik:RadMultiSelect ID="RadMultiSelect1" runat="server"
@@ -214,5 +214,6 @@ End Function
 ````
 
 ## See Also
-* [Get Server Text and Value]({%slug  multiselect/server-side-programming/overview%}#get-selected-text-and-value)
+
+* [Get Server Text and Value]({%slug multiselect/server-side-programming/overview%}#get-selected-text-and-value)
 

controls/multiselect/functionality/tag-mode.md

@@ -12,16 +12,16 @@ position: 3
 
 **RadMultiSelect** provides options for displaying the items as individual (multiple) tags and as a single, summary tag. The available modes are (you can see them in **Figure 1**):
  * `Single` - renders only one tag that shows the number of the selected values
- * `Multiple` - renders a tag for every selected value. This is the default tag mode.
+ * `Multiple` - renders a tag for every selected value. This is the *default* tag mode.
 
 ![multiselect-tag-modes](../images/multiselect-tag-mode.gif)
 
-Every `TagMode` has a specific `TagTemplate` value. You can control the content of the rendered tags by setting a custom a [TagTemplate]]({%slug multiselect/functionality/templates%}#tag-template) value.
+Every `TagMode` has a specific `TagTemplate` value. You can control the content of the rendered tags by customizing [TagTemplate]({%slug multiselect/functionality/templates%}#tag-template) value.
 
 >caption Example 1: RadMultiSelect with single tag mode
 
 ````ASP.NET
-<telerik:RadMultiSelect ID="RadMultiSelect1" runat="server"  Filter="Contains" Width="240px"
+<telerik:RadMultiSelect ID="RadMultiSelect1" runat="server" Filter="Contains" Width="240px"
     DataTextField="text" DataValueField="value" TagMode="Single">
     <Items>
         <telerik:MultiSelectItem Text="Apples" Value="1"></telerik:MultiSelectItem>

controls/multiselect/functionality/templates.md

@@ -13,13 +13,14 @@ position: 1
 **RadMultiSelect** uses [Kendo UI Templates](https://docs.telerik.com/kendo-ui/framework/templates/overview) to provide full control over the rendering of items, selected values, and popup headers. The control supports the following templates:
 
 - [Templates](#templates)
-	- [Item template](#item-template)
-	- [Tag Template](#tag-template)
-	- [Header Template](#header-template)
-	- [Footer Template](#footer-template)
-	- [No Data Template](#no-data-template)
-	- [Group Template](#group-template)
-	- [See Also](#see-also)
+  - [Item template](#item-template)
+  - [Tag Template](#tag-template)
+  - [Header Template](#header-template)
+  - [Footer Template](#footer-template)
+  - [Group Template](#group-template)
+  - [Fixed Group Template](#fixed-group-template)
+  - [No Data Template](#no-data-template)
+  - [See Also](#see-also)
 
 >caption Figure 1: Structure of the popup and where you can use templates. 
 
@@ -170,6 +171,10 @@ This is the [https://docs.telerik.com/kendo-ui/api/javascript/ui/multiselect/con
 
 The template for the header of the group that is not the current topmost group. By default the value of the field by which the data is grouped is displayed and it is sent to the template via the `data` argument.
 
+## Fixed Group Template
+
+The template for the current (topmost) group. It renders just below the column headers and uses the current filter field value by default. This value is sent to the template via the `data` argument.
+
 ## No Data Template
 
 This [template](https://docs.telerik.com/kendo-ui/api/javascript/ui/multiselect/configuration/nodatatemplate) is shown when the data source is empty or the current filter operation returned no results.

controls/multiselect/getting-started.md

@@ -11,23 +11,23 @@ position: 1
 # Getting Started 
 
 
-The following tutorial demonstrates how you can add **RadMultiSelect** bound to static items collection. The end result will be similar to **Figure 1**:
+The following tutorial demonstrates how you can add a **RadMultiSelect** control populated with static items. The end result will be similar to **Figure 1**:
 
 >caption Figure 1: Basic RadMultiSelect configuration with static items
 
 ![multiselect-getting-started](images/multiselect-getting-started.png)
 
 1. Add a **ScriptManager** control on a Web Form.
 
-1. Add a **RadMultiColumnComboBox** control to the page, and set its properties:
+2. Add a **RadMultiColumnComboBox** control to the page, and set its properties:
 
-    * `DataTextField` and `DataValueField` - set them to `text` and `value` when no datasource is used.
+    * `DataTextField` and `DataValueField` - set them to `text` and `value` when populated with MultiSelectItems.
     * Populate the `Items` collection with `MultiSelectItem` instances and set their properties:
         * `Text` - the text of the item.
         * `Value` - the value of the item.
-    * `FooterTemplate` - you can set custom footer template to the **RadMultiSelect** popup here
-    * `Filter` - set it to "`contains`" to enable generic filtering.
-    * Set other properties like `Placeholder`, `Height` and `Width` to control its appearance as desired.
+    * `FooterTemplate` - you can set custom footer template to the **RadMultiSelect** popup here.
+    * `Filter` - set it to "`Contains`" to enable generic filtering.
+    * Set other properties like `Placeholder`, `DropDownHeight` and `Width` to control its appearance as desired.
 
     The end result should be similar to the following: