Split doc edits

Author: maud-lv

articles/azure-app-configuration/index.yml

@@ -51,6 +51,8 @@ landingContent:
           url: concept-point-time-snapshot.md
         - text: Feature Management
           url: concept-feature-management.md
+        - text: Experimentation
+          url: concept-experimentation.md
         - text: Configuration files
           url: concept-config-file.md
         - text: Azure App Configuration Events 
@@ -132,7 +134,7 @@ landingContent:
         links:
           - text: What are feature flags?
             url: concept-feature-management.md
-          - text: Experimentation
+          - text: What is experimentation?
             url: concept-experimentation.md
       - linkListType: quickstart
         links:

articles/azure-app-configuration/run-experiments-aspnet-core.md

@@ -475,7 +475,7 @@ The app we created only specifies one event, but you can have multiple events an
 
 To put your newly setup experiment to the test and generate results for you to analyze, simulate some traffic to your application and wait a 10 to 15 minutes.
 
-To view the results of your experiment, navigate to **Feature Manager** and on the list of variant feature flags, select the **Active** link under the **Experiment** label in the grid view or click on **...** > **Experiment**.
+To view the results of your experiment, navigate to **Feature Manager** and on the list of variant feature flags, click on **...** > **Experiment**, or select the **Active** link in the **Experiment** column. This column isn't displayed by default. To show it, in **Feature manager**, select **Manage view** > **Edit Columns** > **Add Column** > **Experiment** and  **Apply**.
 
 On the results page, a **Version** of the Experiment, a **Baseline** to compare the results against, and a **Comparison** variant are selected by default. If needed, change the defaults per your liking, then select **Apply** to view the result of your experiment.
 

articles/partner-solutions/includes/split-experimentation-workspace-create-form.md

@@ -1,6 +1,6 @@
 ---
 title: Create a Split Experimentation Workspace (preview)
-description: Start running an experiment by creating a Split Experimentation Workspace (preview) from an App Configuration store, from Azure Marketplace or from the Azure search bar.
+description: Start running an experiment by creating a Split Experimentation Workspace (preview) from an App Configuration store, from Azure Marketplace, or from the Azure search bar.
 #customerintent: As a developer, I want to learn how to get started with Split Experimentation, by creating a Split Experimentation workspace.
 author: maud-lv
 ms.author: malev
@@ -24,57 +24,76 @@ Split Experimentation allows you to run A/B tests for your applications and gath
 - An [Azure storage account](../../storage/common/storage-account-create.md)
 - A [Workspace-based Application Insights resource connected to an App Configuration store](../../azure-app-configuration/run-experiments-aspnet-core.md#connect-an-application-insights-preview-resource-to-your-configuration-store).
 
-## Create a Split Experimentation Workspace from an App Configuration store
+## Find Split Experimentation Workspace (preview)
 
-Split Experimentation is available from the left menu in App Configuration. To create a new Split Experimentation Workspace from an App Configuration store, follow the process below.
+Find Split Experimentation Workspace (preview) in one of the following ways:
 
-### Find Split Experimentation Workspace
+- Find Split Experimentation Workspace from Azure App Configuration.
+    1. Open the App Configuration store in which you want to create the Split Experimentation Workspace, then select **Experimentation > Split Experimentation Workspace (preview)** from the left menu.
 
-1. Open the App Configuration store in which you want to create the Split Experimentation Workspace, then select **Experimentation > Split Experimentation Workspace (preview)** from the left menu.
+        :::image type="content" source="./media/create/find-in-app-configuration-store.png" alt-text="Screenshot of the Azure portal, finding resource from the App Configuration store left menu.":::
+    1. On this panel, under the Split Experimentation Workspace label, select **Create new**.
 
-    :::image type="content" source="./media/create/find-in-app-configuration-store.png" alt-text="Screenshot of the Azure portal, finding resource from the App Configuration store left menu.":::
+        :::image type="content" source="./media/create/create-new-option.png" alt-text="Screenshot of the Azure portal, selecting Create new Split Experimentation Workspace.":::
 
-1. On this page, under the Split Experimentation Workspace label, select **Create New**. This action opens a new panel.
+- Find Split Experimentation Workspace from the Azure search bar.
 
-    :::image type="content" source="./media/create/create-new-option.png" alt-text="Screenshot of the Azure portal, selecting Create new Split Experimentation Workspace.":::
+    1. Open the Azure portal homepage, go to the search bar at the top, and enter *Split Experimentation Workspace*.
 
-### Fill out the resource creation form
+        :::image type="content" source="./media/create/find-in-azure-portal-search.png" alt-text="Screenshot of the Azure portal, finding Split Experimentation Workspace from the search bar.":::
 
-[!INCLUDE [Split Experimentation Workspace create form](../includes/split-experimentation-workspace-create-form.md)]
+    1. Under **Services**, select **Split Experimentation Workspace (preview)**, then select **Create** or **Create Split Experimentation Workspace (preview)**.
 
-## Create a Split Experimentation Workspace from Azure Marketplace
+        :::image type="content" source="./media/create/create-new-workspace.png" alt-text="Screenshot of the Azure portal, creating a new workspace.":::
 
-Split Experimentation Workspace is available in Azure Marketplace. To create a Split Experimentation Workspace from Azure Marketplace, follow the steps below.
+- Find Split Experimentation Workspace from Azure Marketplace.
 
-### Find Split Experimentation Workspace
+    1. In the Azure portal, go to **Marketplace**, then, in the pane that opens, enter **Split Experimentation** and select **Split Experimentation for Azure App Configuration**.
 
-1. In the Azure portal, go to **Marketplace**.
-1. In the pane that opens, enter **Split Experimentation**, then select **Split Experimentation for Azure App Configuration**.
-1. Select a plan from the **Plan** dropdown list and select **Subscribe**.
+        :::image type="content" source="./media/create/find-in-azure-marketplace.png" alt-text="Screenshot of the Azure portal, creating a new workspace from Azure Marketplace.":::
 
-### Fill out the resource creation form
+    1. The **Monthly Pay As You Go** plan is selected by default. Click on **Subscribe**.
 
-[!INCLUDE [Split Experimentation Workspace create form](../includes/split-experimentation-workspace-create-form.md)]
+## Basics
 
-## Create a Split Experimentation Workspace from the Azure portal search bar
+Under **Basics**, select or enter the following information, then select **Next**. This tab contains basic information about your Split Experimentation Workspace.
 
-The Azure portal provides direct access to create a Split Experimentation Workspace.
+:::image type="content" source=".\media\create\create-basic-tab.png" alt-text="Screenshot of the Azure portal, filling out the basic tab to create a new resource.":::
 
-### Find Split Experimentation Workspace
+- **Subscription:** Select the Azure subscription you want to use for the resource.
+- **Resource group:** Select an existing resource group or create a new one for the resource.
+- **Resource name** Enter a name for your Split Experimentation Workspace.
+- **Region:** Select the region where you want to deploy the resource.
+- **Pricing plan:** **Monthly Pay As You Go** is displayed on screen. This is the only plan available.
 
-1. Open the Azure portal homepage, go to the search bar at the top, and enter *Split Experimentation Workspace*. Under **Services**, select **Split Experimentation Workspace (preview)**.
+## Data source
 
-    :::image type="content" source="./media/create/find-in-azure-portal-search.png" alt-text="Screenshot of the Azure portal, finding Split Experimentation Workspace from the search bar.":::
+Under **Data Source**, select the following information, then select **Next**. The data source is the resource that provides Split with the feature flag impressions and events data for analyzing the experiments.
 
-1. Select **Create** or **Create Split Experimentation Workspace (preview)**.
+:::image type="content" source=".\media\create\create-data-source-tab.png" alt-text="Screenshot of the Azure portal, filling out the data source tab to create a new resource.":::
 
-    :::image type="content" source="./media/create/create-new-workspace.png" alt-text="Screenshot of the Azure portal, creating a new workspace.":::
+- Enable **Data Ingestion** by selecting the checkbox to allow ingestion of impressions and events from the data source. If you deselect the checkbox, you can enable data ingestion later using the App Configuration portal by navigating to **Experimentation > Split Experimentation Workspace.**
 
-    This action opens a new panel. Select or enter the requested information following the instructions below.
+> [!NOTE]
+> If you do not enable **Data Ingestion** for your Split Experimentation Workspace resource, feature evaluation and customer events will not be exported from your **Data Source** to Split.
 
-### Fill out the resource creation form
+- Under **Log Analytics workspace**, select the **Application Insights** resource you want to use for this experiment. It must be the same Application Insights workspace you connected to your App Configuration store in the previous step.
+- Under **Export Destination Details**, select the **Storage Account** you want to use for storing impressions and events data. A data export rule will be created in the selected Log Analytics workspace to export data to the storage account entered and configured below.
 
-[!INCLUDE [Split Experimentation Workspace create form](../includes/split-experimentation-workspace-create-form.md)]
+> [!NOTE]
+> When creating a new storage account for your experimentation, you must use the same region as your Log Analytics workspace.
+
+## Data access policy
+
+Under **Data Access Policy**, select the Microsoft Entra ID application to use for authentication and authorization in your Split workspace, then select **Review + create**.
+
+:::image type="content" source=".\media\create\create-data-access-policy-tab.png" alt-text="Screenshot of the Azure portal, filling out the data access policy tab to create a new resource.":::
+
+If your group already uses a shared enterprise application, you may contact the administrator of your group to add you as a user. Otherwise, [create and set up your Microsoft Entra ID application](../../partner-solutions/split-experimentation/how-to-set-up-data-access.md) for Split Experimentation Workspace, then add yourself as a user.
+
+## Review and create
+
+Under **Review + create**, review the information listed for your new Split Experimentation resource, read the terms, and select **Create**.
 
 ## Next step
 

articles/partner-solutions/split-experimentation/create.md

@@ -29,10 +29,13 @@ For more information about the experimentation metrics, go to [Create experiment
 
 :::image type="content" source="media/manage/experimentation-metrics.png" alt-text="Screenshot of the Azure platform showing experimentation metrics.":::
 
-## Configure Data Source
+## Configure data source
 
 Under **Configuration** > **Data Source**, configure the Log Analytics workspace and storage account for your Split Experimentation Workspace.
 
+  > [!NOTE]
+  > When creating a new storage account for your experimentation, you must use the same region as your Log Analytics workspace.
+
 - Under **Log Analytics workspace**, you find a link to the Log Analytics workspace that provides Split with the impressions and events data.
 - Under **Export Destination Details**, you find a link to the storage account where the information used by Split is stored.
 

articles/partner-solutions/split-experimentation/manage.md

@@ -17,13 +17,23 @@ This functionality is facilitated through the integration of [Azure App Configur
 
 ## Experimentation in Azure App Configuration
 
-This new feature experimentation in Azure App Configuration is built by integrating App Configuration with Application Insights and Split. As you go about setting up your first experiment, the key steps include creating and configuring the Azure resource setup for the experimentation flow.  
+This new feature experimentation, in Azure App Configuration, is built by integrating App Configuration with Application Insights and Split. As you go about setting up your first experiment, the key steps include creating and configuring the Azure resource setup for the experimentation flow.  
 
 The below diagram depicts the Azure resources for experimentation and the high-level data flow for experiments.
 
    :::image type="content" source="media/overview/diagram.png" alt-text="Diagram that shows how Split Experimentation Workspace interacts with other Azure resources." lightbox="media/overview/diagram.png":::
 
-To get started, follow the quickstart to [create a Split Experimentation Workspace](create.md), and then [set up the experiments for your application](../../azure-app-configuration/run-experiments-aspnet-core.md) in App Configuration store. 
+To get started, follow the quickstart to [create a Split Experimentation Workspace](create.md), and then [set up the experiments for your application](../../azure-app-configuration/run-experiments-aspnet-core.md) in App Configuration store.
+
+## Prerequisites
+
+To set up an experimentation, the Azure subscription Owner, or subscription Contributor with User Access Administrator role is required.
+
+## Billing
+
+Split Experimentation Workspace (preview) is available through a pay-as-you-go monthly plan. With this plan, you receive the Split charges on your Azure monthly bill.
+
+More information about pricing is available on [Azure Marketplace](https://ms.portal.azure.com/#view/Microsoft_Azure_Marketplace/GalleryItemDetailsBladeNopdl/id/splitio1614896174525.azure-experimentation).
 
 ## Next step