more small fixes

Mariya Pershina · Mariya Pershina · commit 83810ff4ce12 · 2025-06-19T15:11:01.000+02:00
diff --git a/assemblies/cli-guide/assembly_reviewing-analysis-reports.adoc b/assemblies/cli-guide/assembly_reviewing-analysis-reports.adoc
@@ -15,7 +15,7 @@ endif::[]
 
 :context: reviewing-analysis-reports
 
-After analyzing an application, you can access an analysis report to check the details of the entire application migration effort.
+After analyzing an application, you can access an analysis report to check the details of the application migration effort.
 
 include::topics/mta-cli/proc_accessing-analysis-report.adoc[leveloffset=+1]
 
diff --git a/docs/cli-guide/master.adoc b/docs/cli-guide/master.adoc
@@ -34,7 +34,7 @@ include::assemblies/cli-guide/assembly_generating-assets.adoc[leveloffset=+1]
 // include::topics/mta-exclude-files-and-packages.adoc[leveloffset=+2]
 
 // CLI known issues
-include::topics/cli-tool-known-issues.adoc[leveloffset=+1]
+include::topics/mta-cli/cli-tool-known-issues.adoc[leveloffset=+1]
 
 include::assemblies/cli-guide/assembly_reference-material.adoc[leveloffset=+1]
 
diff --git a/docs/topics/cli-tool-known-issues.adoc b/docs/topics/cli-tool-known-issues.adoc
diff --git a/docs/topics/mta-cli/proc_accessing-analysis-report.adoc b/docs/topics/mta-cli/proc_accessing-analysis-report.adoc
@@ -12,9 +12,9 @@ When you run an application analysis, a report is generated in the output direct
 * Copy the path of the `index.html` file from the analysis output and paste it in a browser of your choice:
 +
 [subs="+quotes"]
-----
+....
 Report created: _<output_report_directory>_/index.html
           	Access it at this URL: file:///_<output_report_directory>_/index.html
-----
+....
 +
 Alternatively, press *Ctrl* and click on the path of the `index.html` file.
diff --git a/docs/topics/mta-cli/proc_analyze-selected-provider.adoc b/docs/topics/mta-cli/proc_analyze-selected-provider.adoc
@@ -5,7 +5,7 @@
 [id="analyze-selected-provider_{context}"]
 = Analyzing an application for the selected supported language provider
 
-When analyzing an application by using the {ProductFullName} CLI, you can explicitly set a supported language provider according to your application’s language to run the analysis for. 
+You can explicitly set a supported language provider according to your application’s language to run the analysis for. 
 
 
 .Prerequisites
diff --git a/docs/topics/mta-cli/proc_analyze-unsupported-provider.adoc b/docs/topics/mta-cli/proc_analyze-unsupported-provider.adoc
@@ -5,7 +5,7 @@
 [id="analyze-unsupported-provider_{context}"]
 = Analyzing an application for an unsupported language provider
 
-When analyzing an application by using the {ProductFullName} CLI, you can run the analysis for an unsupported language provider. To do so, you must overwrite the existing supported language provider with your own unsupported language provider. 	 
+You can run the analysis for an unsupported language provider. To do so, you must overwrite the existing supported language provider with your own unsupported language provider. 	 
 
 IMPORTANT: You must create a configuration file for your unsupported language provider before overriding the supported provider. 
 
@@ -14,7 +14,7 @@ IMPORTANT: You must create a configuration file for your unsupported language pr
 
 * You created a configuration file for your unsupported language provider, for example:
 +
-----
+....
 [
 {
 "name": "java",
@@ -29,7 +29,7 @@ IMPORTANT: You must create a configuration file for your unsupported language pr
 }]
 }
 ]
-----
+....
 
 .Procedure
 
diff --git a/docs/topics/mta-cli/proc_analyzing-multiple-apps-with-mta-cli.adoc b/docs/topics/mta-cli/proc_analyzing-multiple-apps-with-mta-cli.adoc
@@ -44,5 +44,5 @@ $ *mta-cli analyze --bulk --input _<path_to_input_C>_ --output _<path_to_output_
 [role="_additional-resources"]
 .Additional resources
 
-* xref:installing-cli-zip_installing-mta-cli[Installing the CLI .zip file]
+* xref:installing-cli-zip_installing-mta-cli[Installing the CLI by using a .zip file]
 * xref:mta-cli-analyze-flags_analyzing-applications-mta-cli[The mta-cli analyze command options]
diff --git a/docs/topics/mta-cli/proc_analyzing-single-app-with-mta-cli.adoc b/docs/topics/mta-cli/proc_analyzing-single-app-with-mta-cli.adoc
@@ -18,7 +18,7 @@ NOTE: Extracting the list of dependencies from compiled Java binaries is not alw
 $ *mta-cli analyze --list-targets*
 ....
 
-. Run the `{mta-cli}` binary:
+. Run the analysis:
 +
 [subs="+quotes"]
 ....
@@ -30,27 +30,36 @@ Specify the following arguments:
 * `--input`: An application to be evaluated.
 * `--output`: An output directory for the generated reports. `mta-cli analyze` creates the following analysis reports: 
 +
-----
+....
 ./
 ├── analysis.log
 ├── dependencies.yaml
 ├── output.yaml
 ├── shim.log
 ├── static-report
 └── static-report.log
-----
+....
 
 * `--source`: A source technology for the application migration, for example, `weblogic`.
 * `--target`: A target technology for the application migration, for example, `eap8`.
 
-. Access the generated analysis reports:
+. Access the generated analysis report:
+
+.. In the output of the `mta-cli analyze` command, copy a path to the `index.html` analysis report file:
++
+[subs="+quotes"]
+....
+Report created: _<output_report_directory>_/index.html
+          	Access it at this URL: file:///_<output_report_directory>_/index.html
+....
 
-.. In the output of the `mta-cli analyze` command, copy a path to the analysis report file.
 .. Paste the path to the browser of your choice. 
 
++
+Alternatively, press *Ctrl* and click on the path to the report file. 
 
 [role="_additional-resources"]
 .Additional resources
 
-* xref:installing-cli-zip_installing-mta-cli[Installing the CLI .zip file]
+* xref:installing-cli-zip_installing-mta-cli[Installing the CLI by using a .zip file]
 * xref:mta-cli-analyze-flags_analyzing-applications-mta-cli[The mta-cli analyze command options]
diff --git a/docs/topics/mta-cli/proc_installing-cli-for-docker.adoc b/docs/topics/mta-cli/proc_installing-cli-for-docker.adoc
@@ -42,7 +42,7 @@ By default, Docker Desktop is installed to the `C:\Program Files\Docker\Docker`
 .. Ensure that Docker will run Windows containers as the backend instead of Linux containers:
 
 ... In the Windows task bar, right-click on the Docker icon.
-... Click Switch to Windows containers.
+... Click *Switch to Windows containers*.
 
 . In PowerShell, create a folder for {ProductShortName}:
 +
diff --git a/docs/topics/mta-cli/proc_installing-mta-disconnected-environment.adoc b/docs/topics/mta-cli/proc_installing-mta-disconnected-environment.adoc
@@ -6,7 +6,10 @@
 [id="installing-mta-disconnected-environment_{context}"]
 = Installing the CLI on a disconnected environment
 
-When your system is in a disconnected environment, you can install the {ProductFullName} command-line interface (CLI) by using an external computer to download the required images and by copying these images to the system you want to install {ProductShortName} CLI on.
+When your system is in a disconnected environment, you can install the {ProductFullName} command-line interface (CLI) by performing the following actions:
+
+. Download the required images by using an external computer.
+. Copying the downloaded images to the system you want to install {ProductShortName} CLI on.
 
 IMPORTANT: The following procedure applies only to container mode.
 
@@ -18,9 +21,9 @@ NOTE: The analysis output in the disconnected environment usually results in les
 * You installed the Podman tool on your system.
 * For the analysis of Java applications, you enabled container runtime usage by setting the `--run-local` flag to `false`: 
 +
-----
+....
 --run-local=false
-----
+....
 +
 The analysis of non-Java applications runs in container mode by default.
 
@@ -32,44 +35,43 @@ The analysis of non-Java applications runs in container mode by default.
 .. Authenticate to registry.redhat.io:
 +
 [subs="+quotes"]
-----
+....
 $ *podman login registry.redhat.io*
-----
+....
 
 .. Run the `mta-cli` binary file. The binary file pulls the required provider images. For example:
 +
 [subs="+quotes"]
-----
+....
 $ *mta-cli analyze*
-----
+....
 +
 IMPORTANT: This command only pulls the required images. For example, if you  run a command that requires Java images, a .NET image will not be pulled.
 
 .. Display the image list:
 +
 [subs="+quotes"]
-----
-
+....
 $ *podman images*
 REPOSITORY                                                        TAG         IMAGE ID      CREATED       SIZE
 registry.redhat.io/mta/mta-generic-external-provider-rhel9        7.3.1       8b8d7fa14570  13 days ago   692 MB
 registry.redhat.io/mta/mta-cli-rhel9                              7.3.1       45422a12d936  13 days ago   1.6 GB
 registry.redhat.io/mta/mta-java-external-provider-rhel9           7.3.1       4d6d0912a38b  13 days ago   715 MB
 registry.redhat.io/mta/mta-dotnet-external-provider-rhel9         7.3.1       66ec9fc51408  13 days ago   1.27 GB
-----
+....
 
 .. Save the images:
 +
 [subs="+quotes"]
-----
+....
 $ *podman save _<image_ID>_ -o _<image_name>_.image*
-----
+....
 
 .. Copy the images onto a USB drive or directly to the file system of the disconnected device. 
 
 . On the disconnected device, enter:
 +
 [subs="+quotes"]
-----
+....
 $ *podman load --input _<image_name>_.image*
-----
+....
diff --git a/docs/topics/mta-cli/proc_running-the-containerless-mta-cli.adoc b/docs/topics/mta-cli/proc_running-the-containerless-mta-cli.adoc
@@ -55,5 +55,5 @@ NOTE: The `--overwrite` option overwrites the output folder if it exists.
 [role="_additional-resources"]
 .Additional resources
 
-* xref:installing-cli-zip_installing-mta-cli[Installing the CLI .zip file]
+* xref:installing-cli-zip_installing-mta-cli[Installing the CLI by using a .zip file]
 * xref:mta-cli-analyze-flags_analyzing-applications-mta-cli[The mta-cli analyze command options]
diff --git a/docs/topics/mta-cli/ref_analysis-report-sections.adoc b/docs/topics/mta-cli/ref_analysis-report-sections.adoc
@@ -5,7 +5,7 @@
 [id="analysis-report-sections_{context}"]
 = Analysis report sections
 
-The following are sections of the analysis report that you can review after an application analysis is complete. These sections contain additional details about the migration of an application.
+The following are sections of an analysis report that are available after the application analysis is complete. These sections contain additional details about the migration of an application.
 
 NOTE: You can only review the report applicable to the current application.
 
@@ -24,7 +24,7 @@ include::../snippets/technology-preview-admonition.adoc[]
 
 Insights do not impact the migration. For example, a rule searching for deprecated API usage in the code that does not impact the current migration but can be tracked and fixed when needed in the future. 		
 
-Unlike issues, insights do not need to be fixed for a successful migration. They are generated by any rule that does not have a positive effort value and category assigned. They might have a message and tag.
+Unlike with issues, you do not need to fix insights for a successful migration. They are generated by any rule that does not have a positive effort value and category assigned. They might have a message and tag.
 |====
 
 

Original file line number	Diff line number	Diff line change
`@@ -12,9 +12,9 @@ When you run an application analysis, a report is generated in the output direct`
`12`	`12`	* Copy the path of the `index.html` file from the analysis output and paste it in a browser of your choice:
`13`	`13`	`+`
`14`	`14`	`[subs="+quotes"]`
`15`		`-----`
	`15`	`+....`
`16`	`16`	`Report created: _<output_report_directory>_/index.html`
`17`	`17`	`Access it at this URL: file:///_<output_report_directory>_/index.html`
`18`		`-----`
	`18`	`+....`
`19`	`19`	`+`
`20`	`20`	Alternatively, press Ctrl and click on the path of the `index.html` file.
Original file line number	Diff line number	Diff line change
`@@ -5,7 +5,7 @@`
`5`	`5`	`[id="analyze-unsupported-provider_{context}"]`
`6`	`6`	`= Analyzing an application for an unsupported language provider`
`7`	`7`
`8`		`-When analyzing an application by using the {ProductFullName} CLI, you can run the analysis for an unsupported language provider. To do so, you must overwrite the existing supported language provider with your own unsupported language provider.`
	`8`	`+You can run the analysis for an unsupported language provider. To do so, you must overwrite the existing supported language provider with your own unsupported language provider.`
`9`	`9`
`10`	`10`	`IMPORTANT: You must create a configuration file for your unsupported language provider before overriding the supported provider.`
`11`	`11`
`@@ -14,7 +14,7 @@ IMPORTANT: You must create a configuration file for your unsupported language pr`
`14`	`14`
`15`	`15`	`* You created a configuration file for your unsupported language provider, for example:`
`16`	`16`	`+`
`17`		`-----`
	`17`	`+....`
`18`	`18`	`[`
`19`	`19`	`{`
`20`	`20`	`"name": "java",`
`@@ -29,7 +29,7 @@ IMPORTANT: You must create a configuration file for your unsupported language pr`
`29`	`29`	`}]`
`30`	`30`	`}`
`31`	`31`	`]`
`32`		`-----`
	`32`	`+....`
`33`	`33`
`34`	`34`	`.Procedure`
`35`	`35`
Original file line number	Diff line number	Diff line change
@@ -42,7 +42,7 @@ By default, Docker Desktop is installed to the `C:\Program Files\Docker\Docker`
`42`	`42`	`.. Ensure that Docker will run Windows containers as the backend instead of Linux containers:`
`43`	`43`
`44`	`44`	`... In the Windows task bar, right-click on the Docker icon.`
`45`		`-... Click Switch to Windows containers.`
	`45`	`+... Click Switch to Windows containers.`
`46`	`46`
`47`	`47`	`. In PowerShell, create a folder for {ProductShortName}:`
`48`	`48`	`+`