Merge pull request #173658 from MicrosoftDocs/release-ga-purview

Release ga purview--scheduled release branch at 8AM of 9/28

Author: huypub

articles/purview/abap-functions-deployment-guide.md

@@ -6,7 +6,7 @@ ms.author: kchandra
 ms.service: purview
 ms.subservice: purview-data-catalog
 ms.topic: conceptual
-ms.date: 11/13/2020
+ms.date: 09/27/2021
 ---
 
 # Deploy the metadata extraction ABAP function module for the SAP R3 family of bridges
@@ -61,7 +61,7 @@ In Object Navigator select **Function Group** from the list and type its name in
 
 1. Once the function group is created, select it.
 
-2. Right-click on the function group name in repository browser, and select **Create**, then **Function Module**.
+2. Select and hold (or right-click) on the function group name in repository browser, and select **Create**, then **Function Module**.
 
 3. In the **Function Module** field, enter `Z_MITI_DOWNLOAD`. Populate **Short text** input with proper description.
 
@@ -108,7 +108,7 @@ When the module has been created, specify the following information:
 
 7. Save the function (press ctrl+S or choose **Function Module**, then **Save** in the main menu).
 
-8. Click **Activate** icon on the toolbar (ctrl+F3) and select  **Continue** button in dialog window. If prompted, you should select  the generated includes to be activated along with the main function module.
+8. Select the **Activate** icon on the toolbar (ctrl+F3) and select  **Continue** button in dialog window. If prompted, you should select  the generated includes to be activated along with the main function module.
 
 ### Testing the Function
 

articles/purview/apply-classifications.md

@@ -1,12 +1,12 @@
 ---
-title: Apply classifications on assets (preview)
+title: Apply classifications on assets
 description: This document describes how to apply classifications on assets.
 author: SunetraVirdi
 ms.author: suvirdi
 ms.service: purview
-ms.subservice: purview-data-catalog
+ms.subservice: purview-data-map
 ms.topic: how-to
-ms.date: 11/19/2020
+ms.date: 09/27/2021
 ---
 # Apply classifications on assets in Azure Purview
 

articles/purview/asset-insights.md

@@ -1,18 +1,21 @@
 ---
-title: Asset insights on your data in Azure Purview (preview)
+title: Asset insights on your data in Azure Purview
 description: This how-to guide describes how to view and use Purview Insights asset reporting on your data. 
 author: SunetraVirdi
 ms.author: suvirdi
 ms.service: purview
-ms.subservice: purview-data-catalog
+ms.subservice: purview-insights
 ms.topic: how-to
-ms.date: 11/20/2020
+ms.date: 09/27/2021
 ---
 
 # Asset insights on your data in Azure Purview
 
 This how-to guide describes how to access, view, and filter Purview Asset insight reports for your data.
 
+> [!IMPORTANT]
+> Azure Purview Insights are currently in PREVIEW. The [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) include additional legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
+
 In this how-to guide, you'll learn how to:
 
 > [!div class="checklist"]
@@ -28,7 +31,7 @@ Before getting started with Purview insights, make sure that you've completed th
 
 * Set up and complete a scan on the source type.
 
-For more information, see [Manage data sources in Azure Purview (Preview)](manage-data-sources.md).
+For more information, see [Manage data sources in Azure Purview](manage-data-sources.md).
 
 ## Use Purview Asset Insights
 
@@ -43,11 +46,11 @@ In Azure Purview, you can register and scan source types. Once the scan is compl
 
    :::image type="content" source="./media/asset-insights/portal-access.png" alt-text="Launch Purview from the Azure portal":::
 
-1. On the Purview **Home** page, select the **View insights** tile to access your **Insights** :::image type="icon" source="media/asset-insights/ico-insights.png" border="false"::: area.
+1. On the Purview **Home** page, select **Insights** on the left menu.
 
    :::image type="content" source="./media/asset-insights/view-insights.png" alt-text="View your insights in the Azure portal":::
 
-1. In the **Insights** :::image type="icon" source="media/asset-insights/ico-insights.png" border="false"::: area, select **Assets** to display the Purview **Asset insights** report.
+1. In the **Insights** area, select **Assets** to display the Purview **Asset insights** report.
 
 ### View Asset Insights
 
@@ -85,7 +88,7 @@ The next couple of graphs in Asset Insights show a distribution of file based so
    > [!NOTE]
    > If the scan has run only once in last 30 days or any catalog change like classification addition/removed happened only once in 30 days, then the change information above appears blank.
 
-1. See the top folders with change top asset counts when you click on source type.
+1. See the top folders with change top asset counts when you select source type.
 
 1. Select the path to see the asset list.
 

articles/purview/catalog-asset-details.md

@@ -6,7 +6,7 @@ ms.author: viseshag
 ms.service: purview
 ms.subservice: purview-data-catalog
 ms.topic: how-to
-ms.date: 08/10/2021
+ms.date: 09/27/2021
 ---
 # View, edit and delete assets in Purview catalog
 
@@ -65,7 +65,7 @@ Asset glossary terms are a managed vocabulary for business terms that can be use
 
 ## Editing assets
 
-You can edit an asset by clicking on the edit icon on the top-left corner of the asset.
+You can edit an asset by selecting the edit icon on the top-left corner of the asset.
 
 :::image type="content" source="media/catalog-asset-details/asset-edit-delete.png" alt-text="Asset edit and delete buttons":::
 
@@ -83,7 +83,7 @@ If you make a column level update, like adding a description, column level class
 
 ## Deleting assets
 
-You can delete an asset by clicking on the delete icon under the name of the asset.
+You can delete an asset by selecting the delete icon under the name of the asset.
 
 ### Delete behavior explained
 

articles/purview/catalog-lineage-user-guide.md

@@ -1,12 +1,11 @@
 ---
-title: Data Catalog lineage user guide (preview)
+title: Data Catalog lineage user guide
 description: This article provides an overview of the catalog lineage feature of Azure Purview.
 author: chanuengg
 ms.author: csugunan
 ms.service: purview
-ms.subservice: purview-data-catalog
 ms.topic: conceptual
-ms.date: 08/25/2021
+ms.date: 09/27/2021
 ---
 # Azure Purview Data Catalog lineage user guide
 
@@ -106,7 +105,7 @@ Data process can take one or more input datasets to produce one or more outputs.
 
    :::image type="content" source="./media/catalog-lineage-user-guide/select-switch-to-asset.png" alt-text="Screenshot how to select Switch to asset in a lineage data asset." lightbox="./media/catalog-lineage-user-guide/select-switch-to-asset.png":::
 
-2. The lineage canvas could become complex for popular datasets. To avoid clutter, the default view will only show five levels of lineage for the asset in focus. The rest of the lineage can be expanded by clicking the bubbles in the lineage canvas. Data consumers can also hide the assets in the canvas that are of no interest. To further reduce the clutter, turn off the toggle **More Lineage** at the top of lineage canvas. This action will hide all the bubbles in lineage canvas.
+2. The lineage canvas could become complex for popular datasets. To avoid clutter, the default view will only show five levels of lineage for the asset in focus. The rest of the lineage can be expanded by selecting the bubbles in the lineage canvas. Data consumers can also hide the assets in the canvas that are of no interest. To further reduce the clutter, turn off the toggle **More Lineage** at the top of lineage canvas. This action will hide all the bubbles in lineage canvas.
 
    :::image type="content" source="./media/catalog-lineage-user-guide/use-toggle-to-hide-bubbles.png" alt-text="Screenshot showing how to toggle More lineage." lightbox="./media/catalog-lineage-user-guide/use-toggle-to-hide-bubbles.png":::
 

articles/purview/catalog-permissions.md

@@ -1,12 +1,11 @@
 ---
-title: Catalog Permissions (preview)
-description: This article gives an overview of how to configure Role-Based Access Control (RBAC) in the Azure Purview
+title: Understand access and permissions
+description: This article gives an overview permissions, access control, and collections in Azure Purview. Role-based access control (RBAC) is managed within Azure Purview itself, so this guide will cover the basics to secure your information.
 author: viseshag
 ms.author: viseshag
 ms.service: purview
-ms.subservice: purview-data-catalog
 ms.topic: conceptual
-ms.date: 08/18/2021
+ms.date: 09/27/2021
 ---
 
 # Access control in Azure Purview
@@ -26,10 +25,10 @@ A collection is a tool Azure Purview uses to group assets, sources, and other ar
 
 Azure Purview uses a set of predefined roles to control who can access what within the account. These roles are currently:
 
-- **Collection admins** - can edit Purview collections, their details, and add subcollections. They can also add users into other Purview roles on collections where they're admins.
-- **Data source admins** - can manage data sources and data scans.
-- **Data curators** - can create, read, modify, and delete catalog data assets and establish relationships between assets.
-- **Data readers** - can access but not modify catalog data assets.
+- **Collection admins** - a role for users that will need to assign roles to other users in Azure Purview or manage collections. Collection admins can add users to roles on collections where they're admins. They can also edit collections, their details, and add subcollections.
+- **Data curators** - a role  that provides access to the data catalog to manage assets, configure custom classifications, set up glossary terms, and review insights. Data curators can create, read, modify, move, apply annotations to, and delete assets.
+- **Data source admins** - a role that can manage data sources and scans. A user in the Data source admin role alone doesn't have access to the Azure Purview studio. Combining this role with the Data reader or Data curator roles provides broader access.
+- **Data readers** - a role that provides read-only access to data assets, classifications, classification rules, collections, glossary, and insights.
 
 ## Who should be assigned to what role?
 
@@ -47,7 +46,7 @@ Azure Purview uses a set of predefined roles to control who can access what with
 
 ## Understand how to use Azure Purview's roles and collections
 
-All access control is managed in Purview's collections. Purview's collections can be found in the [Purview Studio](use-purview-studio.md). Open your Purview account in the [Azure portal](https://portal.azure.com) and select the Purview Studio tile on the Overview page. From there, navigate to the data map on the left menu, and then select the 'Collections' tab.
+All access control is managed in Purview's collections. Purview's collections can be found in the [Purview Studio](https://ms.web.purview.azure.com/resource/). Open your Purview account in the [Azure portal](https://portal.azure.com) and select the Purview Studio tile on the Overview page. From there, navigate to the data map on the left menu, and then select the 'Collections' tab.
 
 When an Azure Purview account is created, it starts with a root collection that has the same name as the Purview account itself. The creator of the Purview account is automatically added as a Collection Admin, Data Source Admin, Data Curator, and Data Reader on this root collection, and can edit and manage this collection.
 
@@ -86,7 +85,7 @@ Similarly with the Data Curator and Data Source Admin roles, permissions for tho
 
 ### Add users to roles
 
-Role assignment is managed through the collections. Only a user with the [collection admin role](#roles) can grant permissions to other users on that collection. When new permissions need to be added, a collection admin will access the Purview Studio, navigate to data map, then the collections tab, and select the collection where a user needs to be added. From the Role Assignments tab they will be able to add and manage users who need permissions.
+Role assignment is managed through the collections. Only a user with the [collection admin role](#roles) can grant permissions to other users on that collection. When new permissions need to be added, a collection admin will access the [Purview Studio](https://ms.web.purview.azure.com/resource/), navigate to data map, then the collections tab, and select the collection where a user needs to be added. From the Role Assignments tab they will be able to add and manage users who need permissions.
 
 For full instructions, see our [how-to guide for adding role assignments](how-to-create-and-manage-collections.md#add-role-assignments).
 
@@ -131,7 +130,7 @@ Only two built-in control plane roles in Azure can assign users roles, those are
 #### An example of assigning someone to a legacy role
 
 1. Go to https://portal.azure.com and navigate to your Azure Purview Account
-1. On the left-hand side click on "Access control (IAM)"
+1. On the left-hand side, select **Access control (IAM)**
 1. Then follow the general instructions given [here](../role-based-access-control/quickstart-assign-role-user-portal.md#create-a-resource-group)
 
 ### Legacy role definitions and actions
@@ -142,7 +141,7 @@ A role is defined as a collection of actions. See [here](../role-based-access-co
 
 If you want to be given access to an Azure Purview Account so you can use its studio or call its APIs you need to be added into an Azure Purview Data Plane Role. The only people who can do this are those who are Owners or User Access Administrators on the Azure Purview Account. For most users the next step is to find a local administrator who can help you find the right people who can give you access.
 
-For users who have access to their company's [Azure portal](https://portal.azure.com) they can look up the particular Azure Purview Account they want to join, click on its "Access control (IAM)" tab and see who the Owners or User Access Administrators (UAAs) are. But note that in some cases Azure Active Directory groups or Service Principals might be used as Owners or UAAs, in which case it might not be possible to contact them directly. Instead one has to find an administrator to help.
+For users who have access to their company's [Azure portal](https://portal.azure.com) they can look up the particular Azure Purview Account they want to join, select its **Access control (IAM)** tab and see who the Owners or User Access Administrators (UAAs) are. But note that in some cases Azure Active Directory groups or Service Principals might be used as Owners or UAAs, in which case it might not be possible to contact them directly. Instead one has to find an administrator to help.
 
 ### Legacy - who should be assigned to what role?
 

articles/purview/catalog-private-link-account-portal.md

@@ -6,7 +6,7 @@ ms.author: viseshag
 ms.service: purview
 ms.subservice: purview-data-catalog
 ms.topic: how-to
-ms.date: 08/18/2021
+ms.date: 09/27/2021
 # Customer intent: As an Azure Purview admin, I want to set up private endpoints for my Azure Purview account for secure access.
 ---
 
@@ -15,7 +15,7 @@ In this guide, you will learn how to deploy private endpoints for your Purview a
 
 The Azure Purview _account_ private endpoint is used to add another layer of security by enabling scenarios where only client calls that originate from within the virtual network are allowed to access the Azure Purview account. This private endpoint is also a prerequisite for the portal private endpoint.
 
-The Azure Purview _portal_ private endpoint is required to enable connectivity to Azure Purview Studio using a private network.
+The Azure Purview _portal_ private endpoint is required to enable connectivity to [Azure Purview Studio](https://ms.web.purview.azure.com/resource/) using a private network.
 
 > [!NOTE]
 > If you only create _account_ and _portal_ private endpoints, you won't be able to run any scans. To enable scanning on a private network, you will need to [create an ingestion private endpoint also](catalog-private-link-end-to-end.md).
@@ -84,7 +84,7 @@ There are two ways you can add Azure Purview _account_ and _portal_ private endp
 
 ### Use the Azure portal (Azure Purview account)
 
-1. Go to the [Azure portal](https://portal.azure.com), and then click on to your Azure Purview account, and under **Settings** select **Networking**, and then select **Private endpoint connections**.
+1. Go to the [Azure portal](https://portal.azure.com), and then select your Azure Purview account, and under **Settings** select **Networking**, and then select **Private endpoint connections**.
 
     :::image type="content" source="media/catalog-private-link/pe-portal.png" alt-text="Screenshot that shows creating an account private endpoint.":::
 

articles/purview/catalog-private-link-end-to-end.md

@@ -6,7 +6,7 @@ ms.author: zeinam
 ms.service: purview
 ms.subservice: purview-data-catalog
 ms.topic: how-to
-ms.date: 08/18/2021
+ms.date: 09/27/2021
 # Customer intent: As an Azure Purview admin, I want to set up private endpoints for my Azure Purview account to access purview account and scan data sources from restricted network.
 ---
 
@@ -16,7 +16,7 @@ In this guide, you will learn how to deploy _account_, _portal_ and _ingestion_
 
 The Azure Purview _account_ private endpoint is used to add another layer of security by enabling scenarios where only client calls that originate from within the virtual network are allowed to access the Azure Purview account. This private endpoint is also a prerequisite for the portal private endpoint.
 
-The Azure Purview _portal_ private endpoint is required to enable connectivity to Azure Purview Studio using a private network.
+The Azure Purview _portal_ private endpoint is required to enable connectivity to [Azure Purview Studio](https://ms.web.purview.azure.com/resource/) using a private network.
 
 Azure Purview can scan data sources in Azure or an on-premises environment by using _ingestion_ private endpoints. Three private endpoint resources are required to be deployed and linked to Azure Purview managed resources when ingestion private endpoint is deployed:
 
@@ -87,7 +87,7 @@ Using one of the deployment options explained further in this guide, you can dep
 
 ## Option 2 - Enable _account_, _portal_ and _ingestion_ private endpoint on existing Azure Purview accounts
 
-1. Go to the [Azure portal](https://portal.azure.com), and then click on to your Azure Purview account, and under **Settings** select **Networking**, and then select **Private endpoint connections**.
+1. Go to the [Azure portal](https://portal.azure.com), and then select your Azure Purview account, and under **Settings** select **Networking**, and then select **Private endpoint connections**.
 
     :::image type="content" source="media/catalog-private-link/pe-portal.png" alt-text="Screenshot that shows creating an account private endpoint.":::