pm-edits

Author: shlipsey3

articles/active-directory/reports-monitoring/media/overview-recommendations/resource-mark-as-option.png

@@ -22,12 +22,13 @@ ms.collection: M365-identity-device-management
 
 This feature is supported as part of a public preview. For more information about previews, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
 
-Ideally, you want your Azure Active Directory (Azure AD) tenant to be in a secure and healthy state. However, keeping track of all the settings and resources in your tenant can be overwhelming. Azure AD recommendations feature helps keep track of the status of your tenant so you don't have to.
+Keeping track of all the settings and resources in your tenant can be overwhelming. The Azure AD recommendations (preview) feature helps monitor the status of your tenant so you don't have to. Azure AD recommendations helps ensure your tenant is in a secure and healthy state while also helping you maximize the value of the features available in Azure AD.
 
 The Azure AD recommendations feature provides you personalized insights with actionable guidance to:
 
 - Help you identify opportunities to implement best practices for Azure AD-related features.
 - Improve the state of your Azure AD tenant.
+- Optimize the configurations for your scenarios.
 
 This article gives you an overview of how you can use Azure AD recommendations. As an administrator, you should review your tenant's recommendations, and their associated resources periodically. 
 
@@ -41,7 +42,7 @@ Azure AD recommendations is the Azure AD specific implementation of [Azure Advis
 
 On a daily basis, Azure AD analyzes the configuration of your tenant. During this analysis, Azure AD compares the data of a recommendation with the actual configuration of your tenant. If a recommendation is flagged as applicable to your tenant, the recommendation appears in the **Recommendations** section of the Azure AD Overview area. Recommendations are listed in order of priority so you can quickly determine where to focus first. 
 
-Recommendations contain a description, a summary of the value of addressing the recommendation, and a step-by-step action plan. All impacted resources are listed, so you can resolve each affected area. 
+Recommendations contain a description, a summary of the value of addressing the recommendation, and a step-by-step action plan. If applicable, impacted resources that are associated with the recommendation are listed, so you can resolve each affected area. If a recommendation doesn't have any associated resources, the impacted resource type is *Tenant level*. so your step-by-step action plan impacts the entire tenant and not just a specific resource.
 
 ![Screenshot of the Overview page of the tenant with the Recommendations option highlighted.](./media/overview-recommendations/recommendations-preview-option-tenant-overview.png)
 
@@ -53,21 +54,12 @@ The **Status** of a recommendation can be updated manually or automatically. If
 
 ![Screenshot of the Mark as options.](./media/overview-recommendations/recommendations-object.png)
 
-- Mark a recommendation as **Completed** if all impacted resources have been addressed.
-    - Active resources may still appear in the list of resources for manually completed recommendations. If the resource is completed, the service will update the status the next time the service runs. 
-    - If the service identifies an active resource for a manually completed recommendation the next time the service runs, the recommendation will automatically change back to **Active**.
-- Mark a recommendation as **Dismissed** if you think the recommendation is irrelevant or the data is wrong.
-    - Azure AD will ask for a reason why you dismissed the recommendation so we can improve the service.
-- Mark a recommendation as **Postponed** if you want to address the recommendation at a later time.
-    - The recommendation will become **Active** when the selected date occurs.
-- You can reactivate a completed or postponed recommendation to keep it top of mind and reassess the resources.
-
-The **Priority** of a recommendation could be low, medium, or high. These values are determined by a variety of factors, such as security implications or expiring credentials.
+The **Priority** of a recommendation could be low, medium, or high. These values are determined by several factors, such as security implications, health concerns, or potential breaking changes.
 
 ![Screenshot of a recommendation's status, priority, and impacted resource type.](./media/overview-recommendations/recommendation-status-risk.png)
 
-- **High**: Must do. Not acting will result in security implications or potential downtime.
-- **Medium**: Should do. Actions will improve your tenant's health, but no risk if action isn't taken.
+- **High**: Must do. Not acting will result in severe security implications or potential downtime.
+- **Medium**: Should do. No severe risk if action isn't taken.
 - **Low**: Might do. No security risks or health concerns if action isn't taken.
 
 The **Impacted resources** for a recommendation could be things like applications or users. This detail gives you an idea of what type of resources you'll need to address. The impacted resource could also be at the tenant level, so you may need to make a global change. 
@@ -76,7 +68,7 @@ The **Status description** tells you the date the recommendation status changed
 
 The recommendation's **Value** is an explanation of why completing the recommendation will benefit you, and the value of the associated feature. 
 
-The **Action plan** provides step-by-step instructions to implement a recommendation.
+The **Action plan** provides step-by-step instructions to implement a recommendation. May include links to relevant documentation or direct you to other pages in the Azure AD portal.
 
 ## What you should know
 
@@ -86,7 +78,7 @@ The following roles provide *read-only* access to recommendations:
 - Security Reader
 - Global Reader
 
-The following roles provide *update* access to recommendations:
+The following roles provide *update and read-only* access to recommendations:
 
 - Global Administrator
 - Security Administrator
@@ -96,25 +88,48 @@ The following roles provide *update* access to recommendations:
 
 Any role can enable the Azure AD recommendations preview, but you'll need one of the roles listed above to view or update recommendations. Azure AD only displays the recommendations that apply to your tenant, so you may not see all supported recommendations listed.
 
-Some recommendations have a list of impacted resources associated. This list of resources gives you more context on how the recommendation applies to you and/or which resources you need to address. The only action recorded in the audit log is completing recommendations.
+Some recommendations have a list of impacted resources associated. This list of resources gives you more context on how the recommendation applies to you and/or which resources you need to address. The only action recorded in the audit log is completing recommendations. Actions taken on a recommendation are collected in the audit log. To view these logs, go to **Azure AD** > **Audit logs** and filter the service to "Azure AD recommendations."
 
 ## How to access Azure AD recommendations (preview)
 
 To enable the Azure AD recommendations preview:
 
 1. Sign in to the [Azure portal](https://portal.azure.com/).
 
-1. Go to **Azure Active Directory** > **Preview features** and enable **Azure AD recommendations.**
+1. Go to **Azure AD** > **Preview features** and enable **Azure AD recommendations.**
    - Recommendations may take a few minutes to sync.  
    - While anyone can enable the preview feature, you'll need a [specific role](overview-recommendations.md#what-you-should-know) to view or update a recommendation. 
 
     ![Screenshot of the Enable Azure AD recommendations option](./media/overview-recommendations/enable-azure-ad-recommendations.png)
 
 After the preview is enabled, you can view the available recommendations from the Azure AD administration portal. The Azure AD recommendations feature appears on the **Overview** page of your tenant.
 
-Select a recommendation from the list to view the details, status, and action plan. Recommendations are listed in priority order, from high to low.
+## How to use Azure AD recommendations (preview)
+
+1. Go to **Azure AD** > **Recommendations**.
+
+1. Select a recommendation from the list to view the details, status, and action plan. 
+
+    ![Screenshot of the list of recommendations.](./media/overview-recommendations/recommendations-list.png)
+
+1. Follow the **Action plan**.
+
+1. If applicable, right-click on a resource in a recommendation, select **Mark as**, then select a status.
+
+    ![Screenshot of the status options for a resource.](./media/overview-recommendations/resource-mark-as-option.png)
+
+1. If you need to manually change the status of a recommendation, select **Mark as** from the top of the page and select a status.
+
+    - Mark a recommendation as **Completed** if all impacted resources have been addressed.
+        - Active resources may still appear in the list of resources for manually completed recommendations. If the resource is completed, the service will update the status the next time the service runs. 
+        - If the service identifies an active resource for a manually completed recommendation the next time the service runs, the recommendation will automatically change back to **Active**.
+    - Mark a recommendation as **Dismissed** if you think the recommendation is irrelevant or the data is wrong.
+        - Azure AD will ask for a reason why you dismissed the recommendation so we can improve the service.
+    - Mark a recommendation as **Postponed** if you want to address the recommendation at a later time.
+        - The recommendation will become **Active** when the selected date occurs.
+    - You can reactivate a completed or postponed recommendation to keep it top of mind and reassess the resources.
 
-![Screenshot of the list of recommendations.](./media/overview-recommendations/recommendations-list.png)
+Continue to monitor the recommendations in your tenant for changes.
 
 ## Next steps