Freshness check and update

Author: whhender

articles/data-share/concepts-pricing.md

@@ -5,7 +5,7 @@ author:  sidontha
 ms.author: sidontha
 ms.service: data-share
 ms.topic: conceptual
-ms.date: 11/15/2022
+ms.date: 12/19/2023
 ---
 
 # Understand Azure Data Share pricing

articles/data-share/concepts-roles-permissions.md

@@ -5,7 +5,7 @@ author: sidontha
 ms.author: sidontha
 ms.service: data-share
 ms.topic: conceptual
-ms.date: 12/18/2023
+ms.date: 12/19/2023
 ms.custom: subject-rbac-steps
 ---
 
@@ -130,7 +130,7 @@ You can follow the [step by step demo video](https://youtu.be/aeGISgK1xro), or t
 - SQL Server Firewall access:
     1. In the [Azure portal](https://portal.azure.com/), navigate to the SQL server and select **Firewalls and virtual networks**.
     1. Select **Yes** for **Allow Azure services and resources to access this server**.
-    1. Select **+Add client IP**. Client IP address can change, so you may need to add your client IP again next time you share data from the portal.
+    1. Select **+Add client IP**. Client IP address can change, so you might need to add your client IP again next time you share data from the portal.
     1. Select **Save**.
 
 For more information about sharing to and from Azure SQL, see [the article to share and receive data from Azure SQL Database.](how-to-share-from-sql.md)
@@ -156,7 +156,7 @@ For more information about sharing to and from Azure SQL, see [the article to sh
 - Synapse workspace Firewall access:
     1. In the [Azure portal](https://portal.azure.com/), navigate to Synapse workspace. Select **Firewalls** from left navigation.
     1. Select **ON** for **Allow Azure services and resources to access this workspace**.
-    1. Select **+Add client IP**. Client IP address can change, so you may need to add your client IP again next time you share data from the portal.
+    1. Select **+Add client IP**. Client IP address can change, so you might need to add your client IP again next time you share data from the portal.
     1. Select **Save**.
 
 #### Receive
@@ -263,7 +263,7 @@ For SQL-based target, a SQL user needs to be created from an external provider i
 
 ## Resource provider registration 
 
-You may need to manually register the Microsoft.DataShare resource provider into your Azure subscription in the following scenarios: 
+You might need to manually register the Microsoft.DataShare resource provider into your Azure subscription in the following scenarios: 
 
 * View Azure Data Share invitation for the first time in your Azure tenant
 * Share data from an Azure data store in a different Azure subscription from your Azure Data Share resource
@@ -288,7 +288,7 @@ This section describes custom roles and permissions required within the custom r
 * For storage and data lake snapshot-based sharing, to add a dataset in Azure Data Share, the provider data share resource's managed identity needs to be granted access to the source Azure data store.  For example, if using a storage account, the data share resource's managed identity is granted the Storage Blob Data Reader role.  
 * To receive data into a storage account, the consumer data share resource's managed identity needs to be granted access to the target storage account. The data share resource's managed identity needs to be granted the Storage Blob Data Contributor role.  
 * See the [Data Provider](#data-provider) and [Data Consumer](#data-consumer) sections of this article for more specific steps. 
-* You may also need to manually register the Microsoft.DataShare resource provider into your Azure subscription for some scenarios. See in [Resource provider registration](#resource-provider-registration) section of this article for specific details. 
+* You might also need to manually register the Microsoft.DataShare resource provider into your Azure subscription for some scenarios. See in [Resource provider registration](#resource-provider-registration) section of this article for specific details. 
 
 ### Create custom roles and required permissions
 

articles/data-share/data-share-troubleshoot.md

@@ -6,18 +6,18 @@ author: sidontha
 ms.author: sidontha
 ms.service: data-share
 ms.topic: troubleshooting
-ms.date: 11/30/2022
+ms.date: 12/19/2023
 ---
 
-# Troubleshoot common problems in Azure Data Share 
+# Troubleshoot common problems in Azure Data Share
 
-This article explains how to troubleshoot common problems in Azure Data Share. 
+This article explains how to troubleshoot common problems in Azure Data Share.
 
-## Azure Data Share invitations 
+## Azure Data Share invitations
 
 In some cases, when new users select **Accept Invitation** in an email invitation, they might see an empty list of invitations. This problem could have one of the following causes:
 
-* **The Azure Data Share service isn't registered as a resource provider of any Azure subscription in the Azure tenant.** This problem happens when your Azure tenant has no Data Share resource. 
+* **The Azure Data Share service isn't registered as a resource provider of any Azure subscription in the Azure tenant.** This problem happens when your Azure tenant has no Data Share resource.
 
     When you create an Azure Data Share resource, it automatically registers the resource provider in your Azure subscription. You can manually register the Data Share service by using the following steps. To complete these steps, you need the [Contributor role](../role-based-access-control/built-in-roles.md#contributor) for the Azure subscription. 
 
@@ -31,7 +31,7 @@ In some cases, when new users select **Accept Invitation** in an email invitatio
 
 * **The invitation is already accepted.** The link in the email takes you to the **Data Share Invitations** page in the Azure portal. This page lists only pending invitations. Accepted invitations don't appear on the page. To view received shares and configure your target Azure Data Explorer cluster setting, go to the Data Share resource you used to accept the invitation.
 
-* **You are guest user of the tenant.** If you're a guest user of the tenant, you'll need to verify your email address for the tenant prior to viewing the invitation. Once verified, it's valid for 12 months. 
+* **You are guest user of the tenant.** If you're a guest user of the tenant, you'll need to verify your email address for the tenant prior to viewing the invitation. Once verified, it's valid for 12 months.
 
 ## Creating and receiving shares
 
@@ -43,18 +43,19 @@ The following errors might appear when you create a new share, add datasets, or
 * You don't have proper permissions to x.
 * We couldn't add write permissions for the Azure Data Share account to one or more of your selected resources.
 
-You might see one of these errors if you have insufficient permissions to the Azure data store. For more information, see [Roles and requirements](concepts-roles-permissions.md). 
+You might see one of these errors if you have insufficient permissions to the Azure data store. For more information, see [Roles and requirements](concepts-roles-permissions.md).
 
-You need the write permission to share or receive data from an Azure data store. This permission is typically part of the Contributor role. 
+You need the write permission to share or receive data from an Azure data store. This permission is typically part of the Contributor role.
 
-If you're sharing data or receiving data from the Azure data store for the first time, you also need the *Microsoft.Authorization/role assignments/write* permission. This permission is typically part of the Owner role. Even if you created the Azure data store resource, you're not necessarily the owner of the resource. 
+If you're sharing data or receiving data from the Azure data store for the first time, you also need the *Microsoft.Authorization/role assignments/write* permission. This permission is typically part of the Owner role. Even if you created the Azure data store resource, you're not necessarily the owner of the resource.
 
 When you have the proper permissions, the Azure Data Share service automatically allows the data share resource's managed identity to access the data store. This process can take a few minutes. If you experience failure because of this delay, try again after a few minutes.
 
 SQL-based sharing requires extra permissions. For information about prerequisites, see [Share from SQL sources](how-to-share-from-sql.md).
 
 ## Snapshots
-A snapshot can fail for various reasons. Open a detailed error message by selecting the start time of the snapshot and then the status of each dataset. 
+
+A snapshot can fail for various reasons. Open a detailed error message by selecting the start time of the snapshot and then the status of each dataset.
 
 Snapshots commonly fail for these reasons:
 
@@ -87,17 +88,19 @@ For SQL sources, a snapshot can fail for these other reasons:
 * A target CSV file is generated, but the data can't be read in Excel. You might see this problem when the source SQL table contains data that includes non-English characters. In Excel, select the **Get Data** tab and choose the CSV file. Select the file origin **65001: Unicode (UTF-8)**, and then load the data.
 
 ## Update snapshot schedule
+
 After the data provider updates the snapshot schedule for the sent share, the data consumer needs to disable the previous snapshot schedule, then enable the updated snapshot schedule for the received share. Snapshot schedule is stored in UTC, and shown in the UI as the computer local time. It doesn't automatically adjust for daylight saving time.  
 
 ## In-place sharing
+
 Dataset mapping can fail for Azure Data Explorer clusters due to the following reasons:
 
-* User doesn't have *write* permission to the Azure Data Explorer cluster. This permission is typically part of the Contributor role. 
+* User doesn't have *write* permission to the Azure Data Explorer cluster. This permission is typically part of the Contributor role.
 * The source or target Azure Data Explorer cluster is paused.
 * Source Azure Data Explorer cluster is EngineV2 and target is EngineV3, or vice versa. Sharing between Azure Data Explorer clusters of different engine versions isn't supported.
 
 ## Next steps
 
-To learn how to start sharing data, continue to the [Share data](share-your-data.md) tutorial. 
+To learn how to start sharing data, continue to the [Share data](share-your-data.md) tutorial.
 
 To learn how to receive data, continue to the [Accept and receive data](subscribe-to-data-share.md) tutorial.

articles/data-share/disaster-recovery.md

@@ -5,21 +5,21 @@ author: sidontha
 ms.author: sidontha
 ms.service: data-share
 ms.topic: how-to
-ms.date: 10/27/2022
+ms.date: 12/19/2023
 ---
 # Disaster recovery for Azure Data Share
 
-This article explains how to configure a disaster recovery environment for Azure Data Share. Azure data center outages are rare, but can last anywhere from a few minutes to hours. Data Center outages can cause disruption to environments that are relying on data being shared by the data provider. By following the steps detailed in this article, data providers can continue to share data with their data consumers in the event of a data center outage for the primary region hosting your data share. 
+This article explains how to configure a disaster recovery environment for Azure Data Share. Azure data center outages are rare, but can last anywhere from a few minutes to hours. Data Center outages can cause disruption to environments that are relying on data being shared by the data provider. By following the steps detailed in this article, data providers can continue to share data with their data consumers if there's a data center outage for the primary region hosting your data share.
 
 ## Achieving business continuity for Azure Data Share
 
-To be prepared for a data center outage, the data provider can have a data share environment provisioned in a secondary region. Measures can be taken to ensure a smooth failover in the event that a data center outage does occur. 
+To be prepared for a data center outage, the data provider can have a data share environment provisioned in a secondary region. Measures can be taken to ensure a smooth failover if a data center outage does occur.
 
-Data providers can provision secondary Azure Data Share resources in an additional region. These Data Share resources can be configured to include shares and datasets that exist in the primary Azure Data Share resource. They can invite data consumers to the secondary shares when configuring the DR environment or at a later time (i.e as part of manual failover steps).
+Data providers can create secondary Azure Data Share resources in another region. These Data Share resources can be configured to include shares and datasets that exist in the primary Azure Data Share resource. They can invite data consumers to the secondary shares when configuring the DR environment or at a later time (i.e as part of manual failover steps).
 
-If the data consumers have active share subscriptions in a secondary environment provisioned for DR purposes, they can enable snapshot schedule as part of failover. If the data consumers do not want to subscribe to a secondary region for DR purposes, they can be invited into the secondary share at a later time. 
+If the data consumers have active share subscriptions in a secondary environment provisioned for DR purposes, they can enable snapshot schedule as part of failover. If the data consumers don't want to subscribe to a secondary region for DR purposes, they can be invited into the secondary share at a later time.
 
-Data consumers can either have an active share subscription that is idle for DR purposes, or data providers can invite them at a later time as part of manual failover procedures. 
+Data consumers can either have an active share subscription that is idle for DR purposes, or data providers can invite them at a later time as part of manual failover procedures.
 
 ## Related information
 

articles/data-share/how-to-add-datasets.md

@@ -5,7 +5,7 @@ author: sidontha
 ms.author: sidontha
 ms.service: data-share
 ms.topic: how-to
-ms.date: 10/27/2022
+ms.date: 12/19/2023
 ---
 
 # How to add datasets to an existing share in Azure Data Share
@@ -16,18 +16,22 @@ For information on how to add datasets as you create a share, see the [Share dat
 
 ## Navigate to a sent data share
 
-In Azure Data Share, navigate to your sent share and select the **Datasets** tab. Click **+ Add Datasets** button to add more datasets.
+In Azure Data Share, navigate to your sent share and select the **Datasets** tab. Select **+ Add Datasets** button to add more datasets.
 
 ![Screenshot shows Add Datasets selected.](./media/how-to/how-to-add-datasets/add-datasets.png)
 
-In the panel on the right, select the dataset type you would like to add and then click **Next**. Select the subscription and resource group of the data you would like to add. Using the dropdown arrows, find and then check the box next to the data to add.
+In the panel on the right, select the dataset type you would like to add and then select **Next**. Select the subscription and resource group of the data you would like to add. Using the dropdown arrows, find and then check the box next to the data to add.
 
 ![Screenshot shows the Add Blob Storage pane where you can select data.](./media/how-to/how-to-add-datasets/add-datasets-side.png)
 
-Once you click **Add Datasets**, the datasets will be added to your share. 
-Note: A snapshot must be triggered by your consumers in order for them to see the new datasets. If there are snapshot settings configured, consumers will see the new datasets once the next scheduled snapshot completes. 
-Without snapshot settings configured, the consumer must manually trigger a full or incremental copy of the data to receive the updates. 
-For more information on snapshots, see [Snapshots](terminology.md).
+Once you select **Add Datasets**, the datasets are added to your share.
+
+>[!NOTE]
+>A snapshot must be triggered by your consumers in order for them to see the new datasets. If there are snapshot settings configured, consumers will see the new datasets once the next scheduled snapshot completes.
+
+Without snapshot settings configured, the consumer must manually trigger a full or incremental copy of the data to receive the updates.
+For more information on snapshots, see [Snapshots](terminology.md#snapshot).
 
 ## Next steps
+
 Learn more about how to [add recipients to an existing data share](how-to-add-recipients.md).

articles/data-share/how-to-add-recipients.md

@@ -5,23 +5,24 @@ author: sidontha
 ms.author: sidontha
 ms.service: data-share
 ms.topic: how-to
-ms.date: 10/27/2022
+ms.date: 12/19/2023
 ---
 # How to add a recipient to your share
 
-You can add recipient when you create a new share or to an existing share. From Azure Data Share UI, you can add recipient using the Azure sign-in email of the user.  From API, you can use a combination of user/service principal and tenant ID. When a tenant ID is specified, the invitation can only be accepted into this tenant. Also from API, you can create an invitation without sending an email to the recipient. 
+You can add recipient when you create a new share or to an existing share. From Azure Data Share UI, you can add recipient using the Azure sign-in email of the user.  From API, you can use a combination of user/service principal and tenant ID. When a tenant ID is specified, the invitation can only be accepted into this tenant. Also from API, you can create an invitation without sending an email to the recipient.
 
 ## Add recipient to an existing share
 
 In Azure Data Share, navigate to your sent share and select the **Invitations** tab. Listed here are all of the recipients of invitations to this data share. To add a new one, select **Add Recipient**.
 
 ![Screenshot shows Add Recipient selected.](./media/how-to/how-to-add-recipients/add-recipient.png)
 
-A panel will pop out on the right side of the page. Select **Add Recipient** and then fill in the email of your new recipient on the blank line. Make sure to use recipient's Azure sign-in email (using their email alias won't work). 
+A panel will pop out on the right side of the page. Select **Add Recipient** and then fill in the email of your new recipient on the blank line. Make sure to use recipient's Azure sign-in email (using their email alias won't work).
 
 ![Screenshot shows the Add Recipient pane where you can Add and send invitation.](./media/how-to/how-to-add-recipients/add-recipient-side.png)
 
 Select **Add and send invitation**. The new recipient(s) will be sent invitation emails to this share.
 
 ## Next steps
+
 Learn more about how to [delete an invitation to a share](how-to-delete-invitation.md).