Add highlighting / supportsHighlight documentation

Capabilities/Capabilities.md

@@ -88,4 +88,10 @@ Types refer to what the property will be. See below for more information about t
 }
 ```
 
-[Learn more about objects](Objects.md)
+[Learn more about objects](Objects.md)
+
+##Handle partial highlighting - `supportsHighlight`
+
+By default this value is set to false which means your "Values" will be automatically filtered when something on the page is selected which will in turn update your visual to display just the selected value. If you want display the full data, but just highlight the selected items you need to set `supportsHighlight` to true in your capabilities.json.
+
+[Learn more about highlighting](Highlighting.md)

Capabilities/Highlighting.md

@@ -0,0 +1,13 @@
+#Highlighting
+
+By default whenever an element is selected the `values` array in the `dataView` object will be filtered to just the selected values. This will cause all other visuals on the page to display just the selected data.
+
+![highlight dataview default behavior](images/highlightDataView.png)
+
+##supportsHighlight
+
+If you set the `supportsHighlight` property in your capabilities.json to true you will receive the full unfiltered `vaules` array along with a `highlights` array. The `highlights` array will be the same length as the values array and any non-selected values will be set to `null`. With this property enabled it is the visual's responsiblity to highlight the appropriate data by comparing the `values` array to the `highlights` array.
+
+![highlight dataview supportsHighlight](images/highlightDataViewSupports.png)
+
+In the example above you'll notice that the one bar that is selected is the only value in the highlights array. It is also important to note there could be multiple selections and partial highlight (where the corresponding numeric value in the values and highlights arrays will be present but different) 

Readme.md

@@ -42,6 +42,7 @@ In this tutorial, you will be building a simple bar chart. The source code is lo
     * [Data Roles](Capabilities/Capabilities.md#define-the-data-fields-your-visual-expects---dataroles)
     * [Data View Mappings](Capabilities/DataViewMappings.md)
     * [Objects](Capabilities/Objects.md)
+    * [Highlighting](Capabilities/Highlighting.md)
 * [Visual Documentation](Visual/Visual.md)
     * [Visual/IVisual Api](Visual/IVisualApi.md)
     * [Handling Selection in Visuals](Visual/Selection.md)