edits

Author: KarlErickson

articles/migrate/appcat/appcat7-cli-guide.md

@@ -1,69 +1,79 @@
 ---
-title: Interpret the AppCAT 7 report
+title: Interpret the AppCAT 7 Report
 description: Azure Migrate application and code assessment tool - Interpret AppCAT report.
 author: KarlErickson
 ms.author: karler
 ms.reviewer: brborges
 ms.service: azure
-ms.custom:
-  - devx-track-java
-  - devx-track-extended-java
-  - build-2025
+ms.custom: devx-track-java, build-2025
 ms.topic: overview
-ms.date: 01/15/2025
+ms.date: 06/27/2025
 #customer intent: As a developer, I want to assess my Java application so that I can understand its readiness for migration to Azure.
 ---
 # Interpret the AppCAT 7 report
-This document guides you through the AppCAT report to help you well understand it for assessing the migration readiness of your Java application to Azure. The report provides a comprehensive overview of the application and its components. You can use this report to gain insights into the structure and dependencies of the application, and to determine its suitability for replatform and modernization.
+
+This article guides you through the AppCAT report to help you well understand it for assessing the migration readiness of your Java application to Azure. The report provides a comprehensive overview of the application and its components. You can use this report to gain insights into the structure and dependencies of the application, and to determine its suitability for replatform and modernization.
+
 ## Application list view
 The landing page of the report presents a overall view of all analyzed applications. From here, you can navigate to individual application reports to explore detailed findings.
 
 :::image type="content" source="media/java/appcat-7-report-applist.png" alt-text="app list of the AppCAT assessment report." lightbox="media/java/appcat-7-report-applist.png":::
+
 ## Application view
+
 The application report consists of 3 sections:
+
 - **Application Information**: Reveals the basic information of your application including Java version, framework, build tool, etc.
 - **Issue Summary**: shows the issue overview for three domains with percentage on issue criticality.
 - The detail report is organized into 4 sub sections:
   - **Issues**: Provides a concise summary of all issues that require attention.
   - **Dependencies**: Displays all Java-packaged dependencies found within the application.
   - **Technologies**: Displays all embedded libraries grouped by functionality, allowing you to quickly view the technologies used in the application.
   - **Insights**: Detailed files and information to better understand detected technologies.
-    
+
 :::image type="content" source="media/java/appcat-7-report-app.png" alt-text="app view of the AppCAT assessment report." lightbox="media/java/appcat-7-report-app.png":::
+
 ### Issues
-Access this part by clicking the Issues tab. It provides a categorized issue list of various aspects of Azure readiness, cloud native, and Java modernization that you need to address to successfully migrate the application to Azure. Learn more about domain and criticality via below sections. 
 
-|Domain|Description|
-|---------|---------|
-|Azure readiness|Identifies app dependencies and suggests equivalent Azure solutions|
-|cloud native|Assesses how well the app follows cloud-native practices like scalability and containerization|
-|Java modernization|Identifies JDK and framework issues for version upgrade|
+Access this part by clicking the Issues tab. It provides a categorized issue list of various aspects of Azure readiness, cloud native, and Java modernization that you need to address to successfully migrate the application to Azure. Learn more about domain and criticality via below sections.
+
+| Domain             | Description                                                                                    |
+|--------------------|------------------------------------------------------------------------------------------------|
+| Azure readiness    | Identifies app dependencies and suggests equivalent Azure solutions                            |
+| cloud native       | Assesses how well the app follows cloud-native practices like scalability and containerization |
+| Java modernization | Identifies JDK and framework issues for version upgrade                                        |
 
-|Criticality|Description|
-|---------|---------|
-|Mandatory|Issues that must be fixed for migration to Azure|
-|Potential|Issues that might impact migration and need review|
-|Optional|Low-impact issues; fixing them is recommended but optional|
+| Criticality | Description                                                |
+|-------------|------------------------------------------------------------|
+| Mandatory   | Issues that must be fixed for migration to Azure           |
+| Potential   | Issues that might impact migration and need review         |
+| Optional    | Low-impact issues; fixing them is recommended but optional |
 
 :::image type="content" source="media/java/appcat-7-report-issues.png" alt-text="issues of the AppCAT assessment report." lightbox="media/java/appcat-7-report-issues.png":::
 
 Each reported issue can be expanded, by clicking on the title, to obtain additional details. The following information is provided:
+
 - A list of files where the incidents occurred, along with the number of code lines impacted. If the file is a Java source file, then clicking the filename will direct you to the corresponding Source report.
 - A detailed description of the issue. This description outlines the problem, provides any known solutions, and references supporting documentation regarding either the issue or resolution.
 
 :::image type="content" source="media/java/appcat-7-report-issue-detail.png" alt-text="issue detail of the AppCAT assessment report." lightbox="media/java/appcat-7-report-issue-detail.png":::
 
 :::image type="content" source="media/java/appcat-7-report-issue-code.png" alt-text="issue code of the AppCAT issue code report." lightbox="media/java/appcat-7-report-issue-code.png":::
-  
+
 ### Technologies
-Access this part by clicking the Technologies tab. The report lists the occurrences of technologies, grouped by function, in the analyzed application. It is an overview of the technologies found in the application, and is designed to assist users in quickly understanding each application’s purpose.
+
+Access this part by clicking the Technologies tab. The report lists the occurrences of technologies, grouped by function, in the analyzed application. It is an overview of the technologies found in the application, and is designed to assist users in quickly understanding each application's purpose.
 
 :::image type="content" source="media/java/appcat-7-report-technologies.png" alt-text="technologies of the AppCAT assessment report." lightbox="media/java/appcat-7-report-technologies.png":::
+
 ### Dependencies
+
 Access this part by clicking the Dependencies tab. Displays all Java-packaged dependencies found within the application.
 
 :::image type="content" source="media/java/appcat-7-report-dependencies.png" alt-text="dependencies of the AppCAT assessment report." lightbox="media/java/appcat-7-report-dependencies.png":::
+
 ### Insights
+
 Access this part by clicking the Insights tab. Detailed files and information to better understand detected technologies.
 
 :::image type="content" source="media/java/appcat-7-report-insights.png" alt-text="Insights of the AppCAT assessment report." lightbox="media/java/appcat-7-report-insights.png":::

articles/migrate/appcat/appcat7-interpret-report.md

@@ -1,23 +1,24 @@
 ---
-title: Quick start to assess a java project using AppCAT 7
+title: "Quickstart: Assess a Java Project using AppCAT 7"
 description: Azure Migrate application and code assessment tool - Quick start to assess a java project.
 author: KarlErickson
 ms.author: karler
 ms.reviewer: brborges
 ms.service: azure
-ms.custom:
-  - devx-track-java
-  - devx-track-extended-java
-  - build-2025
+ms.custom: devx-track-java, build-2025
 ms.topic: overview
-ms.date: 01/15/2025
+ms.date: 06/27/2025
 #customer intent: As a developer, I want to assess my Java application so that I can understand its readiness for migration to Azure.
 ---
-# Quick start to assess a java project using AppCAT 7
-This document describes how to download, install and run AppCAT 7 against a sample Java project. 
+
+# Quickstart: Assess a java project using AppCAT 7
+
+This article describes how to download, install and run AppCAT 7 against a sample Java project.
 
 ## Prerequisites
+
 Before downloading AppCAT, please make sure JDK is installed and configured correctly.
+
 - [Download](/java/openjdk/download#openjdk-17) and [install Microsoft Build of OpenJDK 17](/java/openjdk/install). Ensure that the `JAVA_HOME` environment variable is set.
 
 ## Download and install
@@ -74,34 +75,33 @@ Extract the binary from the downloaded file. You should see the following folder
 ```
 
 ## Run AppCAT against a sample Java project
+
 In following steps, let's do application assessment using AppCAT against [Airsonic-Advanced](https://github.com/airsonic-advanced/airsonic-advanced) - a community-driven, web-based media streamer that enables you to access and share your music collection.
 
 1. To run `appcat` from any location in your terminal, extract the archive to your desired location. Then, update the `PATH` environment variable to include the directory where you extracted the archive.
 
-> [!NOTE]
-> When the `appcat` binary is called, it first looks for its dependencies in the executable folder specified in the `PATH` environment variable. If the dependencies aren't found, it falls back to the user's home directory - **~/.appcat** on Linux/Mac or **%USERPROFILE%\\.appcat** on Windows.
-
-2. Clone the application repository to a local folder using the following command:
+   > [!NOTE]
+   > When the `appcat` binary is called, it first looks for its dependencies in the executable folder specified in the `PATH` environment variable. If the dependencies aren't found, it falls back to the user's home directory - **~/.appcat** on Linux/Mac or **%USERPROFILE%\\.appcat** on Windows.
 
-```sh
-git clone https://github.com/airsonic-advanced/airsonic-advanced.git
-```
+1. Clone the application repository to a local folder using the following command:
 
-3. Run the assessment scripts living in samples folder of the downloaded AppCAT release package with providing the path to the cloned folder above. Depending on your operating system, run the appropriate script, as shown in the following example. The reports are automatically generated and opened in your web browser. You can find the reports under **../samples/report-\*** (Linux/macOS) or **..\samples\report-\*** (Windows).
+   ```sh
+   git clone https://github.com/airsonic-advanced/airsonic-advanced.git
+   ```
 
-# [Linux / macOS](#tab/linux)
+1. Run the assessment scripts living in samples folder of the downloaded AppCAT release package with providing the path to the cloned folder above. Depending on your operating system, run the appropriate script, as shown in the following example. The reports are automatically generated and opened in your web browser. You can find the reports under **../samples/report-\*** (Linux/macOS) or **..\samples\report-\*** (Windows).
 
-```bash
-./samples/run-assessment <path-to-airsonic-advanced>
-```
+   ### [Linux / macOS](#tab/linux)
 
-# [Windows](#tab/windows)
+   ```bash
+   ./samples/run-assessment <path-to-airsonic-advanced>
+   ```
 
-```cmd
-.\samples\run-assessment.bat <path-to-airsonic-advanced>
-```
+   ### [Windows](#tab/windows)
 
----
+   ```cmd
+   .\samples\run-assessment.bat <path-to-airsonic-advanced>
+   ```
 
 > [!NOTE]
 > Ensure that the file permissions for scripts in the extracted folder are set to allow execution.
@@ -115,6 +115,7 @@ In the **samples** directory, you can find the following scripts to run differen
 - **run-assessment-package-only**: Produces a report by assessing specific packages.
 
 ## Next steps
+
 - [Interpret the report](appcat7-interpret-report.md)
 - [CLI Command Guide for AppCAT 7](appcat7-cli-guide.md)
 - [Create custom rules for AppCAT 7](appcat7-rule-guide.md)

articles/migrate/appcat/appcat7-quick-start.md

@@ -1,26 +1,26 @@
 ---
-title: Release notes for AppCAT 7
+title: Release Notes for AppCAT 7
 description: Azure Migrate application and code assessment tool - release notes.
 author: KarlErickson
 ms.author: karler
 ms.reviewer: brborges
 ms.service: azure
-ms.custom:
-  - devx-track-java
-  - devx-track-extended-java
-  - build-2025
+ms.custom: devx-track-java, build-2025
 ms.topic: overview
-ms.date: 01/15/2025
+ms.date: 06/27/2025
 #customer intent: As a developer, I want to assess my Java application so that I can understand its readiness for migration to Azure.
 ---
 
 # Release notes
+
 ### 7.7.0.0 (GA)
+
 This release contains the following fixes and enhancements:
+
 - Added graceful error handling with well-defined exit codes for different kinds of errors.
 - Removed `appcat test` command.
-- Enhanced report with adding application overview section.
-- Bug Fix: fixed mvnw is not executable in Linux and macOS.
+- Enhanced report by adding application overview section.
+- Bug fix: `mvnw` is now executable in Linux and macOS.
 
 ### 7.6.0.7
 
@@ -31,13 +31,13 @@ This release contains the following fixes and enhancements.
 - Show assessment progress by displaying the number of rules processed during assessment.
 - Removed Maven from prerequisites.
 - Replaced `airsonic.war` with `airsonic-advanced` as the sample application in the released artifacts.
-  
+
 ### 7.6.0.6
 
 This release contains the following fixes and enhancements.
 
 - A default **.appcat-ignore** file is now included in the release package by default. This file causes the tool to exclude specified folders or paths that don't need to be analyzed.
-- Fixed the issue of missing dependencies in the report when using `full` mode (specified by using `--mode`).
+- Fixed the issue of missing dependencies in the report when using `full` mode - specified by using `--mode`.
 - Scoped analysis to AppCAT-supported targets when no targets are specified.
 - Ignored comment lines during analysis.
 - Fixed incorrect location for XML rules.
@@ -107,13 +107,14 @@ This release is based on a different set of components of the Konveyor project.
 - New engine based on the [Konveyor Analyzer LSP](https://github.com/konveyor/analyzer-lsp) project, with a CLI based on the [Konveyor Kantra](https://github.com/konveyor/kantra/) project.
 
 ## Known issues
+
 ### 7.7.0.0
 
 - Rules issues:
   - The `azure-system-config-01000` rules aren't being triggered.
   - The `azure-password-01000` rule detects only one violation, even when multiple violations exist in the same file.
 - An error in the Watcher Error channel on Windows: `Windows system assumed buffer larger than it is, events have likely been missed`. This error message appears on the command line during long-running jobs on Windows.
-  
+
 ### 7.6.0.7
 
 - Rules issues:

articles/migrate/appcat/appcat7-release-notes.md

@@ -7,7 +7,7 @@ ms.reviewer: brborges
 ms.service: azure
 ms.custom: devx-track-java, devx-track-extended-java
 ms.topic: overview
-ms.date: 05/28/2025
+ms.date: 06/27/2025
 #customer intent: As a developer, I want to assess my Java application so that I can understand its readiness for migration to Azure.
 ---
 
@@ -19,7 +19,7 @@ For more information, see the Introduction to the [Azure Migrate application and
 
 The AppCAT contains rule-based migration tools that analyze the APIs, technologies, and architectures used by the applications you plan to migrate. In fact, the AppCAT analysis process is implemented using AppCAT rules. AppCAT uses rules internally to extract files from archives, decompile files, scan and classify file types, analyze XML and other file content, analyze the application code, and build the reports.
 
-## Getting start with rules
+## Get started with rules
 
 The [AppCAT ruleset project ](https://github.com/Azure/appcat-konveyor-rulesets) contributes future rules to aid static code analysis as well as issues shared by subject matter experts to aid creation of richer Rulesets.
 

articles/migrate/appcat/appcat7-rule-guide.md

@@ -14,7 +14,7 @@ ms.date: 07/12/2024
 # Azure Migrate application and code assessment for Java
 
 > [!NOTE]
-> This version of *Azure Migrate application and code assessment for Java* is under no maintenance and going to be deprecated. We have released a new version 7.x, based on a new analyzer engine. To download and experiment with the new engine, available for Windows, Linux, and macOS, see [Azure Migrate application and code assessment for Java version 7](./java.md) 
+> This version of *Azure Migrate application and code assessment for Java* is under no maintenance and going to be deprecated. We have released a new version 7.x, based on a new analyzer engine. To download and experiment with the new engine, available for Windows, Linux, and macOS, see [Azure Migrate application and code assessment for Java version 7](./java.md)
 
 This guide describes how to use the Azure Migrate application and code assessment tool for Java to assess and replatform any type of Java application. The tool enables you to evaluate application readiness for replatforming and migration to Azure. This tool is offered as a CLI (command-line interface) and assesses Java application binaries and source code to identify replatforming and migration opportunities for Azure. It helps you modernize and replatform large-scale Java applications by identifying common use cases and code patterns and proposing recommended changes.
 
@@ -61,7 +61,7 @@ When the tool assesses for Cloud Readiness and related Azure services, it can al
 
 ## Download
 
-To use the `appcat` CLI, you must download the ZIP file described in the next section, and have a compatible JDK 11 or JDK 17 installation on your computer. The `appcat` CLI runs on any Java-compatible environment such as Windows, Linux, or Mac, both for Intel, Arm, and Apple Silicon hardware. We recommend you use the [Microsoft Build of OpenJDK](/java/openjdk). 
+To use the `appcat` CLI, you must download the ZIP file described in the next section, and have a compatible JDK 11 or JDK 17 installation on your computer. The `appcat` CLI runs on any Java-compatible environment such as Windows, Linux, or Mac, both for Intel, Arm, and Apple Silicon hardware. We recommend you use the [Microsoft Build of OpenJDK](/java/openjdk).
 
 > [!div class="nextstepaction"]
 > [Download Azure Migrate application and code assessment for Java 6.3.9.0](https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-6.3.9.0-preview.zip). Updated on 2024-12-09.
@@ -145,7 +145,7 @@ Use the following command to initiate discovery and cloud readiness:
     --target discovery cloud-readiness
 ```
 
-This type of report is useful when you don't have a specific Azure service in mind to deploy your application to. 
+This type of report is useful when you don't have a specific Azure service in mind to deploy your application to.
 
 The tool always performs the `discovery` whether or not you include that value in the `--target` parameter.