Skip to content

Commit 8f58efb

Browse files
authored
Update java-preview.md
1 parent 2a0c1b0 commit 8f58efb

File tree

1 file changed

+17
-7
lines changed

1 file changed

+17
-7
lines changed

articles/migrate/appcat/java-preview.md

Lines changed: 17 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -290,8 +290,6 @@ The `--input` flag should point to a file or directory containing XML rules, and
290290
> [!NOTE]
291291
> Ensure that the file permissions for scripts in the extracted folder are set to allow execution.
292292
293-
In the **samples** folder, you can find a sample web application called **airsonic.war**. Airsonic is a web-based media streamer, providing access to your music and enabling you to share it with friends. To learn more about Airsonic, see [Airsonic](https://github.com/airsonic/airsonic).
294-
295293
In the **samples** directory, you can find the following scripts to run different types of analysis:
296294

297295
- **run-assessment**: Provides a report with code assessment and steps for migrating Airsonic to Azure App Service on Tomcat.
@@ -300,18 +298,26 @@ In the **samples** directory, you can find the following scripts to run differen
300298
- **run-assessment-openjdk21**: Generates a report with code assessment and steps for migrating Airsonic to OpenJDK 21.
301299
- **run-assessment-package-only**: Produces a report by assessing specific packages.
302300

303-
Depending on your operating system, run the appropriate script, as shown in the following example:
301+
These scripts are intended to be used with the Airsonic-Advanced project — a community-driven, web-based media streamer that allows you to access and share your music collection.
302+
You can clone the application repository manually using the following command:
303+
```sh
304+
git clone https://github.com/airsonic-advanced/airsonic-advanced.git
305+
```
306+
After cloning, provide the path to the cloned folder when running the assessment scripts. Depending on your operating system, run the appropriate script, as shown in the following example:
307+
308+
> [!NOTE]
309+
> Make sure you have cloned the Airsonic Advanced project to a local path before running the scripts.
304310
305311
# [Linux / macOS](#tab/linux)
306312

307313
```bash
308-
./samples/run-assessment
314+
./samples/run-assessment <path-to-airsonic-advanced>
309315
```
310316

311317
# [Windows](#tab/windows)
312318

313319
```cmd
314-
.\samples\run-assessment.bat
320+
.\samples\run-assessment.bat <path-to-airsonic-advanced>
315321
```
316322

317323
---
@@ -320,7 +326,11 @@ The reports are automatically generated and launched. You can find the reports u
320326

321327
### Summary of the analysis
322328

323-
The landing page of the report lists all the technologies that are used in the application. The dashboard provides a summary of the analysis, including the number of transformation incidents, the incidents categories, or the story points.
329+
The landing page of the report lists all the analyzed applications and its detected issues numbers. After you select an individual application, it will show you more details.
330+
331+
It will show a issue list by different issue domains: Azure Readiness, Cloud Native, and Java Modernization.
332+
333+
that are used in the application. The dashboard provides a summary of the analysis, including the number of transformation incidents, the incidents categories, or the story points.
324334

325335
:::image type="content" source="media/java/appcat-7-report-summary.png" alt-text="Screenshot of the appcat summary report." lightbox="media/java/appcat-7-report-summary.png":::
326336

@@ -334,7 +344,7 @@ The dashboard also shows the *story points*. The story points are an abstract me
334344

335345
The assessment report gives an overview of the transformation issues that would need to be solved to migrate the application to Azure.
336346

337-
These *Issues*, also called *Incidents*, have a severity (*Mandatory*, *Optional*, or *Potential*), a level of effort, and a number indicating the story points. The story points are determined by calculating the number of incidents times the effort required to address the issue.
347+
These *Issues*, also called *Incidents*, have a severity (*Mandatory*, *Optional*, or *Potential*), and the number of impacted code lines.
338348

339349
:::image type="content" source="media/java/appcat-7-report-assessment.png" alt-text="Screenshot of the AppCAT assessment report." lightbox="media/java/appcat-7-report-assessment.png":::
340350

0 commit comments

Comments
 (0)