Merge pull request #275914 from maud-lv/ml-splitupdates

Split doc edits

Author: v-ccolin

articles/azure-app-configuration/concept-experimentation.md

@@ -98,7 +98,7 @@ The following sections detail the roles required to perform experiment-related o
 
 ### Set up experimentation
 
-To set up experimentation with required resources including Split experimentation workspace, the Azure subscription Owner or Contributor and User Access Administrator role is required.
+To set up experimentation with the required resources, including the Split Experimentation Workspace, either the Azure subscription Owner role or the combination of subscription Contributor and User Access Administrator roles is required.
 
 ### Create or update experiment
 

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

@@ -18,6 +18,9 @@ Running experiments on your application can help you make informed decisions to
 
 By doing so, you can make data-driven decisions to improve your application.
 
+> [!NOTE]
+> A quick way to start your experimentation journey is to run the [Quote of the Day AZD sample.](https://github.com/Azure-Samples/quote-of-the-day-dotnet/) This repository provides a comprehensive example, complete with Azure resource provisioning and a first experiment, on how to integrate Azure App Configuration with your .NET applications to run experiments.
+
 In this tutorial, you:
 
 > [!div class="checklist"]
@@ -140,7 +143,7 @@ In this example, you create an ASP.NET web app named _Quote of the Day_. When th
 
     * Adds an Application Insights telemetry client to the application.
     * Adds a telemetry initializer that appends targeting information to outgoing telemetry.
-    * Disables adaptive sampling. For more information about disabling adaptive sampling, go to [Troublehooting](../partner-solutions/split-experimentation/troubleshoot.md#sampling-in-application-insights).
+    * Disables adaptive sampling. For more information about disabling adaptive sampling, go to [Troubleshooting](../partner-solutions/split-experimentation/troubleshoot.md#sampling-in-application-insights).
 
 1. In the root folder *QuoteOfTheDay*, create a new file named *ExampleTargetingContextAccessor.cs*. This creates a new class named `ExampleTargetingContextAccessor`. Paste the content below into the file.
 
@@ -475,7 +478,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
@@ -20,61 +20,83 @@ Split Experimentation allows you to run A/B tests for your applications and gath
 ## Prerequisites
 
 - An Azure subscription. If you don’t have one, [create one for free](https://azure.microsoft.com/free/).
-- An [Entra ID app with required configuration](./how-to-set-up-data-access.md).
+- A [Microsoft Entra ID app with required configuration](./how-to-set-up-data-access.md).
 - 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.":::
+        :::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**.
 
-1. On this page, under the Split Experimentation Workspace label, select **Create New**. This action opens a new panel.
+        :::image type="content" source="./media/create/create-new-option.png" alt-text="Screenshot of the Azure portal, selecting Create new Split Experimentation Workspace.":::
 
-    :::image type="content" source="./media/create/create-new-option.png" alt-text="Screenshot of the Azure portal, selecting Create new Split Experimentation Workspace.":::
+- Find Split Experimentation Workspace from the Azure search bar.
 
-### Fill out the resource creation form
+    1. Open the Azure portal homepage, go to the search bar at the top, and enter *Split Experimentation Workspace*.
 
-[!INCLUDE [Split Experimentation Workspace create form](../includes/split-experimentation-workspace-create-form.md)]
+        :::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.":::
 
-## Create a Split Experimentation Workspace from Azure Marketplace
+    1. Under **Services**, select **Split Experimentation Workspace (preview)**, then select **Create** or **Create Split Experimentation Workspace (preview)**.
 
-Split Experimentation Workspace is available in Azure Marketplace. To create a Split Experimentation Workspace from Azure Marketplace, follow the steps below.
+        :::image type="content" source="./media/create/create-new-workspace.png" alt-text="Screenshot of the Azure portal, creating a new workspace.":::
 
-### Find Split Experimentation Workspace
+- Find Split Experimentation Workspace from Azure Marketplace.
 
-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**.
+    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**.
 
-### Fill out the resource creation form
+        :::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.":::
 
-[!INCLUDE [Split Experimentation Workspace create form](../includes/split-experimentation-workspace-create-form.md)]
+    1. The **Monthly Pay As You Go** plan is selected by default. Click on **Subscribe**.
 
-## Create a Split Experimentation Workspace from the Azure portal search bar
+## Create Split Experimentation Workspace (preview)
 
-The Azure portal provides direct access to create a Split Experimentation Workspace.
+### Basics
 
-### Find Split Experimentation Workspace
+Under **Basics**, select or enter the following information, then select **Next**. This tab contains basic information about your Split Experimentation Workspace.
 
-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)**.
+:::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.":::
 
-    :::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.":::
+- **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. Select **Create** or **Create Split Experimentation Workspace (preview)**.
+### Data source
 
-    :::image type="content" source="./media/create/create-new-workspace.png" alt-text="Screenshot of the Azure portal, creating a new workspace.":::
+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.
 
-    This action opens a new panel. Select or enter the requested information following the instructions below.
+:::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.":::
 
-### Fill out the resource creation form
+- 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.**
 
-[!INCLUDE [Split Experimentation Workspace create form](../includes/split-experimentation-workspace-create-form.md)]
+> [!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.
+
+- 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.
+
+> [!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.