Updates to docs for test studio.

Author: aengusheaney

powerapps-docs/maker/canvas-apps/functions/function-select.md

@@ -26,15 +26,15 @@ If you want one or more controls in the gallery to perform different actions fro
 
 **Select** queues the target **OnSelect** for later processing, which may happen after the current formula has finished being evaluated. **Select** doesn't cause the target **OnSelect** to evaluate immediately, nor does **Select** wait for **OnSelect** to finish being evaluated.
 
-**Select** can't cross the boundaries of container controls, such as a gallery or a form. Controls within a container control can only be the subject of a **Select** function in formulas that are inside the same container control. You can't use **Select** across screens.
+You can't use **Select** across screens.
 
 You can use **Select** only with controls that have an **OnSelect** property.
 
 You can use **Select** only in [behavior formulas](../working-with-formulas-in-depth.md).
 
 A control can't **Select** itself directly or indirectly through other controls.
 
-The select function can also be used in repeating container controls such as gallery. For example, it can be used to specify the row or column to select in a gallery and the control to select within that row or column of the gallery.
+The select function can also be used with a gallery. For example, it can be used to specify the row or column to select in a gallery and the control to select within that row or column of the gallery. When you select a row or column, the gallery selection changes and the **OnSelect** formula on the gallery control is evaluated. If a control within the row or column is provided, the **OnSelect** formula for the child control will be evaluated. 
 
 ## Syntax
 **Select**( *Control* )
@@ -55,15 +55,15 @@ The select function can also be used in repeating container controls such as gal
 
 - *Gallery*	
 
-    ```Select(Gallery1, Row1)```
+    ```Select(Gallery1, 1)```
 
-    Simulates a user selecting Row1 in Gallery1. 
+    Simulates a user selecting row 1 or column 1 in Gallery1. 
 
 - *Gallery*	
 
-    ```Select(Gallery1, Row1, ChildControl1)```
+    ```Select(Gallery1, 1, ChildControl1)```
 
-    Simulates a user selecting ChildConttrol1 in Row1 of Gallery1.
+    Simulates a user selecting ChildConttrol1 in row 1 or column 1 of Gallery1.
 
 #### Basic usage
 
@@ -109,4 +109,13 @@ The select function can also be used in repeating container controls such as gal
 
 	Use individual controls in the gallery to take actions that differ from the gallery's default action.
 
-	![An animation that shows the default value of the OnSelect property for a gallery control, as well as a control that takes a different action](media/function-select/gallery-select.gif)
+	![An animation that shows the default value of the OnSelect property for a gallery control, as well as a control that takes a different action](media/function-select/gallery-select.gif)
+
+7. On the same screen, add a **Button** control, and set its **OnSelect** property to this formula:
+
+	**Select( Gallery1,2,Image1 )**
+
+8. While holding down the Alt key, select the button.
+   
+     A **Image Selected** notification appears across the top of your app. The button click simulated selecting the image in row 2 of the gallery.  
+

powerapps-docs/maker/canvas-apps/functions/function-setproperty.md

@@ -16,7 +16,7 @@ search.app:
 ---
 # SetProperty function in Power Apps Test Studio
 
-The SetProperty function simulates interactions with input controls as if the user had entered or set a value on the control. The following properties can be set using the SetProperty function.
+The SetProperty function simulates interactions with input controls as if the user had entered or set a value on the control. This function is only available if you are writing tests in the Power Apps Test Studio. The following properties can be set using the SetProperty function.
 
 ## Syntax
 
@@ -43,7 +43,9 @@ The SetProperty function simulates interactions with input controls as if the us
 | Combobox | Selected | ```SetProperty(Dropdown1.Selected, {Value:"Sample value"})```
 | Combobox | SelectedItems | ```SetProperty(ComboBox1.SelectedItems, Table({Value:"Sample value"},({Value:"Sample value"}))```
 | ListBox | Selected | ```SetProperty(Listbox1.Selected, {'Value':"Sample value"})```
-| ListBox | SelectedText | ```SetProperty(Listbox1. SelectedText, {'Value':"Sample value"})```
 | ListBox | SelectedItems | ```SetProperty(Listbox1.SelectedItems, Table({Value:"Sample value"},({Value:"Sample value"}))```
-| ListBox | SelectedItemsText | ```SetProperty(Listbox1.SelectedItemsText, Table({Value:"Sample value"},({Value:"Sample value"}))```
 
+### See Also
+
+[Test Studio Overview](../test-studio.md) <br>
+[Working with Test Studio](../working-with-test-studio.md)

powerapps-docs/maker/canvas-apps/functions/function-trace.md

@@ -14,15 +14,20 @@ search.audienceType:
 search.app: 
   - PowerApps
 ---
-# Trace function in Power Apps Test Studio
+# Trace function 
 
-Trace is an optional test expression that can be used to provide additional information in your test results from the **OnTestCaseComplete** event. Trace event messages, as well as any messages for both passed and failed assertions, are contained in a Traces table in the TestCaseResult record. The Traces table has two properties, Message and Timestamp. 
+When used with Test Studio, Trace is an optional expression that can be used to provide additional information in your test results from the **OnTestCaseComplete** event. Trace event messages, as well as any messages for both passed and failed assertions, are contained in a Traces table in the TestCaseResult record. The Traces table has two properties, Message and Timestamp. 
+
+If you have allowed your app to send telemetry data to Azure Application Insights, the Trace function can also be used to send custom event or diagnostic information to your Application Insights resource. You can inspect this data in Application Insights to help diagnose problems or understand usage of your apps and features. Trace information used in Tests will also be recorded in Application Insights. All Trace messages can also be viewed in the Power Apps Monitor tool, which will help in debugging or identifying issues for real-time diagnostic sessions for your app.   
 
 ## Syntax
 
-*Trace(message)*
+*Trace(message, severity, custom_record )*
 
-- *Message* – Required. A text value that creates a record in the Traces table in the TestCaseResult record. 
+- *Message* – Required. The information to be traced. In tests, this creates a record in the Traces table in the TestCaseResult record. 
+- *Severity* - Optional. The severity level of the Trace recorded in Application Insights. Options are Information, Warning or Error. 
+- *custom_record* - Optional. A record containing custom data that will be recorded in Application Insights. 
+  
 
 ### See Also
 

powerapps-docs/maker/canvas-apps/test-studio.md

@@ -91,6 +91,7 @@ While work to provide full control coverage in Power Apps Test Studio is in prog
 - Components.
 - Code components written in the Power Apps Component Framework.
 - Nested galleries.
-- Media controls
+- Media controls.
+- Formula-level-error management experimental feature needs to be turned on for the app.
 - Support for controls not listed in the [Select](./functions/function-select.md) and [SetProperty](./functions/function-setproperty.md) functions.
-- Person type columns in SharePoint.
+- Person type columns.