Merge branch 'release-preview-playwright-service' into mpt-troubleshooting

Author: ntrogh

articles/playwright-testing/concept-determine-optimal-configuration.md

@@ -2,7 +2,7 @@
 title: Optimal test suite configuration
 description: Learn about the factors that affect test completion time in Microsoft Playwright Testing. Get practical steps to determine the optimal Playwright test project configuration.
 ms.topic: conceptual
-ms.date: 09/27/2023
+ms.date: 10/04/2023
 ms.custom: playwright-testing-preview
 ---
 

articles/playwright-testing/how-to-configure-visual-comparisons.md

@@ -2,7 +2,7 @@
 title: Configure visual comparisons
 description: Learn how to configure visual comparisons with Microsoft Playwright Testing.
 ms.topic: how-to
-ms.date: 09/13/2023
+ms.date: 10/04/2023
 ms.custom: playwright-testing-preview
 ---
 

articles/playwright-testing/how-to-manage-access-tokens.md

@@ -2,7 +2,7 @@
 title: Manage workspace access tokens
 description: Learn how to create & manage access tokens to authenticate requests to Microsoft Playwright Testing Preview. Access tokens provide secure access to run tests on the service, and to the Microsoft Playwright Testing API.
 ms.topic: how-to
-ms.date: 09/27/2023
+ms.date: 10/04/2023
 ms.custom: playwright-testing-preview
 ---
 
@@ -43,9 +43,11 @@ To view the list of workspace access tokens:
 
 1. Select the settings icon on the home page to go to the workspace settings.
 
+1. Select the **Access tokens** page to view the list of access tokens.
+
     The **Access tokens** page displays the list of access tokens for the workspace.
 
-    :::image type="content" source="./media/how-to-manage-access-tokens/playwright-testing-view-tokens.png" alt-text="Screenshot that shows the access tokens settings page in the Playwright portal.":::
+    :::image type="content" source="./media/how-to-manage-access-tokens/playwright-testing-view-tokens.png" alt-text="Screenshot that shows the access tokens settings page in the Playwright portal." lightbox="./media/how-to-manage-access-tokens/playwright-testing-view-tokens.png":::
 
 ## Generate a workspace access token
 
@@ -63,17 +65,17 @@ To create a new workspace access token:
 
 1. On the **Access tokens** page, select **Generate new token**.
 
-    :::image type="content" source="./media/how-to-manage-access-tokens/playwright-testing-generate-new-access-token.png" alt-text="Screenshot that shows the access tokens settings page in the Playwright Testing portal, highlighting the 'Generate new token' button.":::
+    :::image type="content" source="./media/how-to-manage-access-tokens/playwright-testing-generate-new-access-token.png" alt-text="Screenshot that shows the access tokens settings page in the Playwright Testing portal, highlighting the 'Generate new token' button." lightbox="./media/how-to-manage-access-tokens/playwright-testing-generate-new-access-token.png":::
 
 1. Enter the access token details, and then select **Generate token**.
 
-    :::image type="content" source="./media/how-to-manage-access-tokens/playwright-testing-generate-token.png" alt-text="Screenshot that shows setup guide in the Playwright Testing portal, highlighting the 'Generate token' button.":::
+    :::image type="content" source="./media/how-to-manage-access-tokens/playwright-testing-generate-token.png" alt-text="Screenshot that shows setup guide in the Playwright Testing portal, highlighting the 'Generate token' button." lightbox="./media/how-to-manage-access-tokens/playwright-testing-generate-token.png":::
 
 1. Copy the access token for the workspace.
 
     You can save the access token in a CI/CD secrets store or use it in an environment variable for running tests interactively.
 
-    :::image type="content" source="./media/how-to-manage-access-tokens/playwright-testing-copy-access-token.png" alt-text="Screenshot that shows how to copy the generated access token in the Playwright Testing portal.":::
+    :::image type="content" source="./media/how-to-manage-access-tokens/playwright-testing-copy-access-token.png" alt-text="Screenshot that shows how to copy the generated access token in the Playwright Testing portal." lightbox="./media/how-to-manage-access-tokens/playwright-testing-copy-access-token.png":::
 
     > [!IMPORTANT]
     > You can only access the token value immediately after you've created it. You can't access the token value anymore at a later time.
@@ -93,7 +95,7 @@ You can only delete access tokens that you created in a workspace. To create an
 
 1. On the **Access tokens** page, select **Delete** next to the access token that you want to delete.
 
-    :::image type="content" source="./media/how-to-manage-access-tokens/playwright-testing-delete-token.png" alt-text="Screenshot that shows how to delete an access tokenin the Playwright portal.":::
+    :::image type="content" source="./media/how-to-manage-access-tokens/playwright-testing-delete-token.png" alt-text="Screenshot that shows how to delete an access tokenin the Playwright portal." lightbox="./media/how-to-manage-access-tokens/playwright-testing-delete-token.png":::
 
 1. Select **Delete** on the deletion confirmation page.
 

articles/playwright-testing/how-to-manage-playwright-workspace.md

@@ -2,7 +2,7 @@
 title: Manage workspaces
 description: Learn how to create and manage Microsoft Playwright Testing workspaces. Use the Playwright portal or Azure portal to manage workspaces.
 ms.topic: how-to
-ms.date: 08/29/2023
+ms.date: 10/04/2023
 ms.custom: playwright-testing-preview
 ---
 
@@ -34,7 +34,7 @@ To get started with running your Playwright tests on cloud browsers, you first c
 
 # [Playwright portal](#tab/playwright)
 
-When you create a workspace in the Playwright portal, a new resource group and a Microsoft Playwright Testing Azure resource are created in your Azure subscription.
+When you create a workspace in the Playwright portal, the service creates a new resource group and a Microsoft Playwright Testing Azure resource in your Azure subscription. The name of the new resource group is based on the workspace name.
 
 [!INCLUDE [Create workspace in Playwright portal](./includes/include-playwright-portal-create-workspace.md)]
 
@@ -46,18 +46,17 @@ When you create a workspace in the Playwright portal, a new resource group and a
     :::image type="content" source="./media/how-to-manage-playwright-workspace/azure-portal-create-resource.png" alt-text="Screenshot that shows the Azure portal menu to create a new resource." lightbox="./media/how-to-manage-playwright-workspace/azure-portal-create-resource.png":::
 
 1. Enter *Microsoft Playwright Testing* in the search box.
-1. Select **Microsoft Playwright Testing (Preview)**.
+1. Select the **Microsoft Playwright Testing (Preview)** card, and then select **Create**.
 
     :::image type="content" source="./media/how-to-manage-playwright-workspace/azure-portal-search-playwright-resource.png" alt-text="Screenshot that shows the Azure Marketplace search page with the Microsoft Playwright Testing search result." lightbox="./media/how-to-manage-playwright-workspace/azure-portal-search-playwright-resource.png":::
 
-1. On the Microsoft Playwright Testing page, select **Create**.
 1. Provide the following information to configure a new Microsoft Playwright Testing workspace:
 
     |Field  |Description  |
     |---------|---------|
     |**Subscription**     | Select the Azure subscription that you want to use for this Microsoft Playwright Testing workspace. |
     |**Resource group**     | Select an existing resource group. Or select **Create new**, and then enter a unique name for the new resource group.        |
-    |**Name**     | Enter a unique name to identify your workspace.<BR>The name can't contain special characters, such as \\/""[]:\|<>+=;,?*@&, or whitespace. |
+    |**Name**     | Enter a unique name to identify your workspace.<BR>The name can only consist of alphanumerical characters, and have a length between 3 and 64 characters. |
     |**Location**     | Select a geographic location to host your workspace. <BR>This location also determines where the test execution results and related artifacts are stored. |
 
     > [!NOTE]
@@ -131,7 +130,7 @@ To view the list of test runs in the Playwright portal:
 
 1. On the workspace home page, you can view the workspace activity log.
 
-    :::image type="content" source="./media/how-to-manage-playwright-workspace/playwright-testing-activity-log.png" alt-text="Screenshot that shows the activity log for a workspace in the Playwright Testing portal.":::
+    :::image type="content" source="./media/how-to-manage-playwright-workspace/playwright-testing-activity-log.png" alt-text="Screenshot that shows the activity log for a workspace in the Playwright Testing portal." lightbox="./media/how-to-manage-playwright-workspace/playwright-testing-activity-log.png":::
 
 ## Delete a workspace
 
@@ -155,7 +154,9 @@ To delete a Playwright workspace:
 # [Azure portal](#tab/portal)
 
 1. Sign in to the [Azure portal](https://portal.azure.com/).
+
 1. Navigate to your Playwright workspace.
+
 1. Select **Delete** to delete the workspace.
 
     :::image type="content" source="./media/how-to-manage-playwright-workspace/azure-portal-delete-workspace.png" alt-text="Screenshot that shows the delete workspace functionality in the Azure portal." lightbox="./media/how-to-manage-playwright-workspace/azure-portal-delete-workspace.png":::
@@ -167,7 +168,7 @@ To delete a Playwright workspace:
 
 ## Related content
 
-- [Optimize regional latency a workspace](./how-to-optimize-regional-latency.md)
+- [Optimize regional latency for a workspace](./how-to-optimize-regional-latency.md)
 
 - [Manage workspace access](./how-to-manage-workspace-access.md)
 

articles/playwright-testing/how-to-manage-workspace-access.md

@@ -2,7 +2,7 @@
 title: Manage workspace access
 description: Learn how to manage access to a Microsoft Playwright Testing workspace by using Azure role-based access control (Azure RBAC). Grant user permissions for a workspace by assigning roles.
 ms.topic: how-to
-ms.date: 08/29/2023
+ms.date: 10/04/2023
 ms.custom: playwright-testing-preview
 ---
 
@@ -39,25 +39,38 @@ Microsoft Playwright Testing workspaces uses three Azure built-in roles. To gran
 
 You can grant a user access to a Microsoft Playwright Testing workspace by using the Azure portal:
 
-1. Sign in to the [Azure portal](https://portal.azure.com), and go to your Microsoft Playwright Testing workspace.
+1. Sign in to the [Playwright portal](https://aka.ms/mpt/portal) with your Azure account.
 
-1. On the left pane, select **Access Control (IAM)**, and then select **Add > Add role assignment**.
+1. Select the workspace settings icon, and then go to the **Users** page.
 
-    If you don't have permissions to assign roles, the Add role assignment option is disabled.
+    :::image type="content" source="media/how-to-manage-workspace-access/playwright-testing-user-settings.png" alt-text="Screenshot that shows the Users page in the workspace settings in the Playwright Testing portal." lightbox="media/how-to-manage-workspace-access/playwright-testing-user-settings.png":::
 
-    :::image type="content" source="media/how-to-manage-workspace-access/add-role-assignment.png" alt-text="Screenshot that shows how to add a role assignment to your workspace in the Azure portal.":::
+1. Select **Manage users for your workspace in the Azure portal** to go to your workspace in the Azure portal.
+
+    Alternately, you can go directly to the Azure portal and select your workspace:
+
+    1. Sign in to the [Azure portal](https://portal.azure.com/).
+    1. Enter **Playwright Testing** in the search box, and then select **Playwright Testing** in the **Services** category.
+    1. Select your Microsoft Playwright Testing workspace from the list.
+    1. On the left pane, select **Access Control (IAM)**.
+
+1. On the **Access Control (IAM)** page, select **Add > Add role assignment**.
+
+    If you don't have permissions to assign roles, the **Add role assignment** option is disabled.
+
+    :::image type="content" source="media/how-to-manage-workspace-access/add-role-assignment.png" alt-text="Screenshot that shows how to add a role assignment to your workspace in the Azure portal." lightbox="media/how-to-manage-workspace-access/add-role-assignment.png":::
 
 1. On the **Role** tab, select **Privileged administrator** roles.
 
 1. Select one of the Microsoft Playwright Testing [default roles](#default-roles), and then select **Next**.
 
-    :::image type="content" source="media/how-to-manage-workspace-access/add-role-assignment-select-role.png" alt-text="Screenshot that shows the list of roles when adding a role assignment in the Azure portal.":::
+    :::image type="content" source="media/how-to-manage-workspace-access/add-role-assignment-select-role.png" alt-text="Screenshot that shows the list of roles when adding a role assignment in the Azure portal." lightbox="media/how-to-manage-workspace-access/add-role-assignment-select-role.png":::
 
 1. On the **Members** tab, make sure **User, group, or service principal** is selected.
 
 1. Select **Select members**, find and select the users, groups, or service principals.
 
-    :::image type="content" source="media/how-to-manage-workspace-access/add-role-assignment-select-members.png" alt-text="Screenshot that shows the member selection interface when adding a role assignment in the Azure portal.":::
+    :::image type="content" source="media/how-to-manage-workspace-access/add-role-assignment-select-members.png" alt-text="Screenshot that shows the member selection interface when adding a role assignment in the Azure portal." lightbox="media/how-to-manage-workspace-access/add-role-assignment-select-members.png":::
 
 1. Select **Review + assign** to assign the role.
 
@@ -73,7 +86,7 @@ You can revoke a user's access to a Microsoft Playwright Testing workspace using
 
 1. In the list of role assignments, add a checkmark next to the user and role you want to remove, and then select **Remove**.
 
-    :::image type="content" source="media/how-to-manage-workspace-access/remove-role-assignment.png" alt-text="Screenshot that shows the list of role assignments and how to delete an assignment in the Azure portal.":::
+    :::image type="content" source="media/how-to-manage-workspace-access/remove-role-assignment.png" alt-text="Screenshot that shows the list of role assignments and how to delete an assignment in the Azure portal." lightbox="media/how-to-manage-workspace-access/remove-role-assignment.png":::
 
 1. Select **Yes** in the confirmation window to remove the role assignment.
 
@@ -109,7 +122,7 @@ Perform the following steps to manage permissions with a custom role:
 
 1. Select the `microsoft.playwrightservice/accounts/write` permission, and then select **Add**.
 
-    :::image type="content" source="media/how-to-manage-workspace-access/custom-role-permissions.png" alt-text="Screenshot that shows the list of permissions for adding to the custom role in the Azure portal, highlighting the permission record to add.":::
+    :::image type="content" source="media/how-to-manage-workspace-access/custom-role-permissions.png" alt-text="Screenshot that shows the list of permissions for adding to the custom role in the Azure portal, highlighting the permission record to add." lightbox="media/how-to-manage-workspace-access/custom-role-permissions.png":::
 
 1. Follow these steps to [add a role assignment](/azure/role-based-access-control/role-assignments-portal) for the custom role to the user account.
 

articles/playwright-testing/how-to-optimize-regional-latency.md

@@ -2,39 +2,51 @@
 title: Optimize regional latency
 description: Learn how to optimize regional latency for a Microsoft Playwright Testing Preview workspace. Choose to run tests on remote browsers in an Azure region nearest to you, or in a fixed region.
 ms.topic: how-to
-ms.date: 09/27/2023
+ms.date: 10/04/2023
 ms.custom: playwright-testing-preview
 ---
 
 # Optimize regional latency for a workspace in Microsoft Playwright Testing Preview
 
 Learn how to minimize the network latency between the client machine and the remote browsers for a Microsoft Playwright Testing Preview workspace.
 
-Microsoft Playwright Testing lets you run your Playwright tests on hosted browsers in the Azure region that's nearest to your client machine (*region affinity*). The service collects the test results in the Azure region of the remote browsers, and then transfers the results to the workspace region.
+Microsoft Playwright Testing lets you run your Playwright tests on hosted browsers in the Azure region that's nearest to your client machine. The service collects the test results in the Azure region of the remote browsers, and then transfers the results to the workspace region.
 
 By default, when you create a new workspace, the service runs tests in an Azure region closest to the client machine. When you disable this setting on the workspace, the service uses remote browsers in the Azure region of the workspace.
 
 > [!IMPORTANT]
 > Microsoft Playwright Testing is currently in preview. For legal terms that apply to Azure features that are in beta, in preview, or otherwise not yet released into general availability, see the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
 
-## Configure region affinity for a workspace
+## Configure regional settings for a workspace
 
-You can configure the region affinity setting on the workspace in the Azure portal.
+You can configure the regional settings for your workspace in the Azure portal.
 
-1. Sign in to the [Azure portal](https://portal.azure.com/).
+1. Sign in to the [Playwright portal](https://aka.ms/mpt/portal) with your Azure account.
 
-1. Go to your Microsoft Playwright Testing workspace.
+1. Select the workspace settings icon, and then go to the **General** page to view the workspace settings.
 
-1. Select **Regional Affinity** in the left pane.
+    :::image type="content" source="./media/how-to-optimize-regional-latency/playwright-testing-general-settings.png" alt-text="Screenshot that shows the workspace settings page in the Playwright Testing portal." lightbox="./media/how-to-optimize-regional-latency/playwright-testing-general-settings.png":::
 
-    :::image type="content" source="./media/how-to-optimize-regional-latency/configure-workspace-region-affinity.png" alt-text="Screenshot that shows the Regional Affinity page in the Azure portal.":::
+1. Select **Select region** to go to your workspace in the Azure portal.
 
-1. Enable or disable region affinity for the workspace by selecting the corresponding action.
+    Alternately, you can go directly to the Azure portal and select your workspace:
 
-    By default, region affinity is enabled when you create a new workspace.
+    1. Sign in to the [Azure portal](https://portal.azure.com/).
+    1. Enter **Playwright Testing** in the search box, and then select **Playwright Testing** in the **Services** category.
+    1. Select your Microsoft Playwright Testing workspace from the list.
+
+1. In your workspace, select **Region Management** in the left pane.
+
+    :::image type="content" source="./media/how-to-optimize-regional-latency/configure-workspace-region-management.png" alt-text="Screenshot that shows the Region Management page in the Azure portal." lightbox="./media/how-to-optimize-regional-latency/configure-workspace-region-management.png":::
+
+1. Choose the corresponding  region selection option.
+
+    By default, the service uses remote browsers in the Azure region that's closest to the client machine to minimize latency.
 
 ## Related content
 
 - Learn more about how to [determine the optimal configuration for optimizing test suite completion](./concept-determine-optimal-configuration.md).
+
 - [Manage a Microsoft Playwright Testing workspace](./how-to-manage-playwright-workspace.md)
+
 - [Understand how Microsoft Playwright Testing works](./overview-what-is-microsoft-playwright-testing.md#how-it-works)

articles/playwright-testing/how-to-test-local-applications.md

@@ -2,7 +2,7 @@
 title: Use remote browsers for local applications
 description: Learn how to run end-to-end for locally deployed applications with Microsoft Playwright Testing Preview. Use cloud-hosted browsers to test apps on localhost or private networks.
 ms.topic: how-to
-ms.date: 09/27/2023
+ms.date: 10/04/2023
 ms.custom: playwright-testing-preview
 ---