implemnting feedback

Author: habibaum

articles/migrate/how-to-build-a-report.md

@@ -16,7 +16,7 @@ This article explains how to build a report (preview) for on‑premises servers
 
 In this article, you’ll learn how to:
 
-- Create a report in Azure Migrate.
+- Create a report on Azure Migrate.
 - Select the appropriate report type, migration preferences, and configuration options.
 - Generate the report to review insights about your discovered servers and workloads.
 - After completing this section, you can generate migration and modernization reports.
@@ -25,57 +25,55 @@ In this article, you’ll learn how to:
 
 Before you build a report, ensure the following:
 
-- You’ve created an Azure Migrate project. You can also use an existing project.
+- You’ve created an Azure Migrate project. You can use an existing project if it is available.
 After the project is created, the Azure Migrate: Discovery and assessment tool is automatically added. 
-- You’ve discovered your IT estate using one of the supported discovery sources, based on your scenario. 
-- All discovery errors are resolved before you generate the report.
+- You’ve discovered your IT estate using one of the supported discovery source for your scenario. 
+- All discovery errors are resolved.
 
 ### Recommendation
 
-
 We recommend the following actions to improve report accuracy:
 
-- Enrich your data by defining environment, migration intent and application.
+- Enrich your data by defining the environment, migration intent, and application.
 - Define the environment for your [workloads to enrich your data](resource-tagging.md).
 - Specify the migration [intent and associated applications](define-manage-applications.md).
 - Enable application auto‑discovery and review the [discovered applications](resource-tagging.md) for accuracy.
 
-## Build a Report
+## Build report
 
 To build a report, follow these steps:
 
-1. From All projects, **All Projects** select your project. [Picture 1] 
-1. Go to **Manage**, and then select **Reports**.
+1. From **All projects**, select your project. 
+
+    :::image type="content" source="./media/how-to-build-a-report/migrate-projects" alt-text="The screenshot how to select your project from the Migrate projects." lightbox="./media/how-to-build-a-report/migrate-projects.png":::
+
+1. On the left pane go to **Manage**, and then select **Reports** (Preview).
 
     :::image type="content" source="./media/how-to-build-a-report/manage-section.png" alt-text="The screenshot how to access and select reports." lightbox="./media/how-to-build-a-report/manage-section.png":::
 
-1. In **Report name**, enter a name for the report. The report name must be unique within the project.  
+1. On the **Generate Report** page, do the following:
+    1. **Name**: Enter a name for the report. The report name must be unique within the project.  
 
     :::image type="content" source="./media/how-to-build-a-report/generate-report.png" alt-text="The screenshot how to generate report." lightbox="./media/how-to-build-a-report/generate-report.png":::
 
-1. Select the report type to generate. For more information, see the supported report types.
-1. Select the required migration preference. Learn more about migration preferences.
-1. Provide the required configuration for generating the report. Learn more about report configuration.
-1. Review your selections, and then select **Build report**.
+    1. **Type**: Select the report type to generate. For more information, see the [supported report types](reports-overview.md#types-of-reports). 
+    1. **Migration preference**: Select the required migration preference. For more information, see [migration preferences](reports-overview.md#migration-preferences-in-azure-migrate-reports).
+    1. **Configuration**: Choose the required configuration to generate the report. For more information, see [report configuration](reports-overview.md#report-configuration).
+    1. Review your selections, and then select **Build report**. 
 
-**Report generation time**: 
-
-- Creating a report takes approximately 15 minutes when you select configurations from an existing assessment.
-- Creating a report takes approximately 1 hour when you define configurations from scratch.
+1. Creating a report by using configurations from an existing assessment takes approximately 15 minutes. Creating a report by defining configurations from scratch takes approximately 1 hour.
 
 ### Download the report
 
-Follow these steps to download a report:
+To download a report, follow these steps:
 
-1. Go to the **Reports** section. All reports created so far are listed here. [Picture 1]
-1. For the report you want to download, select **Download**.
+1. Go to the **Reports** section to view the list of reports created so fa
+1. For the report you want to download, select **Download**. **Download Report** page opens. 
 
     :::image type="content" source="./media/how-to-build-a-report/download-report.png" alt-text="The screenshot how to download report." lightbox="./media/how-to-build-a-report/download-report.png":::
 
-1. Select the required files, and then select **Download**.
+1. Select the required report type, and then select **Download**.
 
     :::image type="content" source="./media/how-to-build-a-report/report-types.png" alt-text="The screenshot how to select the report types and download." lightbox="./media/how-to-build-a-report/report-types.png":::
 
-## Next steps 
-
-Learn more about how to review the generated reports. 
+ 

articles/migrate/media/how-to-build-a-report/migrate-projects.png

@@ -12,13 +12,13 @@ monikerRange:
 
 # Overview of reports (preview)
 
-Azure Migrate reports deliver decision-ready insights by consolidating key information across workloads, security, readiness, and costs. They help stakeholders evaluate Azure targets, business value, and migration strategies with a high-level view of the discovered estate. You can create reports after completing discovery, defining applications, and enriching the inventory with environment and migration intent details.
+Azure Migrate reports provide a high-level view of workload readiness, security, and costs to support migration decisions. Reports are available after discovery and inventory enrichment.
 
 ## What are reports? 
 
 Reports in Azure Migrate help you generate decision-ready executive reports for the modernization and migration of your discovered estate. These reports provide a high-level view of your environment, help evaluate migration and modernization options, and support communication of the business value of moving to Azure. 
 
-Reports are designed to summarize your estate and highlight migration opportunities by bringing together key insights across applications, infrastructure, and data. The outputs are intended to support stakeholder discussions, planning activities, and informed decision-making. 
+Reports summarize your estate and highlight migration opportunities by bringing together key insights across applications, infrastructure, and data. The outputs support stakeholder discussions, planning activities, and informed decision-making. 
 
 Depending on the selected report type and scenario, reports can summarize insights such as:
 - Workload and application summary across your discovered estate, including web apps, databases, and file servers.
@@ -29,23 +29,26 @@ Depending on the selected report type and scenario, reports can summarize insigh
 - Value realization on Azure, including potential savings through Azure benefits, management solutions, and pricing options.
 - Readiness, target recommendations, and Azure cost insights for workloads based on the selected migration preference. 
 - High-level migration wave plan to support phased migration planning.
-- The report generates exportable, read-only outputs in PowerPoint and Excel formats.
+- Exportable, read-only outputs available in PowerPoint and Excel formats.
 
 ## Types of reports 
 
-Azure Migrate provides the following reports to help you assess your environment and plan your migration and modernization journey.
+Azure Migrate provides the following reports to help you assess your environment and plan your migration and modernization journey: [Reports in...e decision | Word]
+
+- [Azure modernization and migration report](#azure-modernization-and-migration-report).
+- [Security insights report](#security-insights-report).
 
 ### Azure modernization and migration report
 
 The Azure modernization and migration report provides a consolidated view of migration and modernization opportunities across applications, infrastructure, data, web apps, file share servers, and software.
 
 This report helps you:
 
-- Understand your current environment and infrastructure
-- Assess security and vulnerability posture
-- Identify software that supports your applications
-- Determine recommended Azure target services, readiness, SKUs, and estimated Azure costs for your selected migration strategy
-- Evaluate return on investment (ROI), business value, and potential savings to support stakeholder discussions and executive decision-making
+- Understand your current environment and infrastructure.
+- Assess security and vulnerability posture.
+- Identify software that supports your applications.
+- Determine recommended Azure target services, readiness, SKUs, and estimated Azure costs for your selected migration strategy.
+- Evaluate return on investment (ROI), business value, and potential savings to support stakeholder discussions and executive decision-making.
 
 [Learn more](#migration-preferences-in-azure-migrate-reports) about the migration strategies supported by the Azure modernization and migration report.
 
@@ -60,31 +63,31 @@ This report helps you:
 
 ## Migration preferences in Azure Migrate reports
 
-When you build a report, you can choose from two migration preferences:
+When you build a report, choose from two migration preferences:
 
 - If you want a slightly more formal Learn tone (optional variant):
-- When generating a report, you can select one of two migration preferences.
+- When generating a report, select one of two migration preferences.
 
 
 | **Migration Strategy** |  **Details**  | **Assessment insights**|
 | --- | --- | --- |
-| **Modernize (Platform as a Service)** | You can get a PaaS preferred recommendation that means, the logic identifies workloads best fit for PaaS targets.<br><br>General servers are recommended with a quick lift and shift recommendation to Azure IaaS. | For SQL Servers, sizing and cost comes from the Recommended report with optimization strategy - *Modernize to PaaS* from Azure SQL assessment.<br><br>For web apps, sizing and cost comes from Azure App Service and Azure Kubernetes Service assessments, with a preference to App Service. For general servers, sizing and cost comes from Azure VM assessment.<br><br>All of these recommendations are aggregated using the heterogenous assessments. |
-| **Migrate (Infrastructure as a Service)** | You can get a quick lift and shift recommendation to Azure IaaS (Azure VM or Azure AVS). | **When Lift and Shift to Azure VM is selected:**<br>For SQL Servers, sizing and cost comes from the *Instance to SQL Server on Azure VM report*.<br><br>For general servers and servers hosting web apps, sizing and cost comes from Azure VM assessment.<br><br>All of these recommendations are aggregated using the heterogenous assessments.<br><br>**When Lift and Shift to Azure VMware Solution is selected:**<br>For all general servers, hosted on VMware, sizing and cost comes from Azure Vmware Solution (AVS) assessment.<br><br>All of these recommendations are aggregated using the heterogenous assessments. |
+| **Modernize (Platform as a Service)** | You can get a PaaS preferred recommendation that means, the logic identifies workloads best fit for PaaS targets.<br><br>General servers are recommended with a quick lift and shift recommendation to Azure IaaS. | For SQL Servers, sizing and cost comes from the Recommended report with optimization strategy - *Modernize to PaaS* from Azure SQL assessment.<br><br>For web apps, sizing and cost comes from Azure App Service and Azure Kubernetes Service assessments, with a preference to App Service. For general servers, sizing and cost comes from Azure VM assessment.<br><br>All of these recommendations are aggregated using the heterogeneous assessments. |
+| **Migrate (Infrastructure as a Service)** | You can get a quick lift and shift recommendation to Azure IaaS (Azure VM or Azure AVS). | **When Lift and Shift to Azure VM is selected:**<br>For SQL Servers, sizing and cost comes from the *Instance to SQL Server on Azure VM report*.<br><br>For general servers and servers hosting web apps, sizing and cost comes from Azure VM assessment.<br><br>All of these recommendations are aggregated using heterogeneous assessments.<br><br>**When Lift and Shift to Azure VMware Solution is selected:**<br>For all general servers, hosted on VMware, sizing and cost comes from Azure VMware Solution (AVS) assessment.<br><br>All of these recommendations are aggregated using the heterogeneous assessments. |
 
 Reports surface Azure recommendations from heterogeneous assessments and provide direct access to those assessments. To review sizing, readiness, and Azure cost estimates in detail, open the relevant assessment for the selected applications or workloads.
 
 ### Discovery sources
 
-You can create a report using either of the following discovery methods:
+Create a report using either of the following discovery methods:
 
 - **Azure Migrate appliance or Azure Migrate collector–based discovery**: Provides the most accurate inventory, metadata, and performance data.
 - **CSV import**: Provides a quick estimate when inventory data is available in CSV format.
 
 ### Report configuration
 
-You can configure report generation in one of the following ways:
+Configure report generation in one of the following ways:
 
-- **Define configuration**: Specify the scope, settings, and configuration to be used when generating the report.
+- **Define configuration**: Specify the scope, settings, and configuration to use when generating the report.
 - **Use configuration from an existing assessment**: Select an existing assessment and reuse its scope, settings, and configuration to generate the report.