Merge pull request #78 from migtools/MTA-4250_QE-feedback-CLI

[To be merged for 7.1] QE feedback for the CLI guide

Author: anarnold97

docs/topics/installing-cli-tool.adoc

@@ -31,7 +31,7 @@ When you encounter `<{ProductShortName}_HOME>` in this guide, replace it with th
 
 
 [id="installing-using-podman_{context}"]
-== Installing the {CLINameTitle} using Podman
+== Installing the {CLINameTitle} by using Podman
 
 You can install the {CLINameTitle} using `podman pull`.
 

docs/topics/mta-cli-analyze-multi-lang-apps.adoc

@@ -5,7 +5,8 @@
 [id="mta-cli-analyze-multi-lang-apps_{context}"]
 = Analyzing multi-language applications with {CLIName}
 
-You can run the application analysis on applications written in multiple languages. You can perform the analysis either of the following ways:
+Starting from {ProductShortName} 7.1.0, you can run the application analysis on applications written in multiple languages. You can perform the analysis either of the following ways:
 
 * Select the supported language provider to run the analysis for.
 * Override the existing supported language provider with your own unsupported language provider and run the analysis for this unsupported provider.
+ 

docs/topics/mta-cli-analyze.adoc

@@ -6,7 +6,8 @@
 [id="mta-cli-analyze_{context}"]
 = Performing analysis using the command line
 
-`Analyze` supports running source code and binary analysis using `analyzer-lsp`.
+`Analyze` supports running source code and binary analysis by using the `analyzer-lsp` tool. `analyzer-lsp` evaluates the rules for the providers and determines rule matches. 	
+
 
 .To run analysis on application source code, run the following command:
 

docs/topics/mta-cli-transform.adoc

@@ -4,9 +4,14 @@
 
 :_mod-docs-content-type: CONCEPT
 [id="mta-cli-transform_{context}"]
-= Performing transformation using the command line
+= Performing transformation by using the command line 
 
-Transform has two subcommands - `openrewrite` and `rules`.
+You can use transformation to perform the following actions:
+
+* Transform Java applications source code by using the `transform openrewrite` command.
+* Convert XML rules to YAML rules by using the `transform rules` command.
+
+IMPORTANT: Performing transformation requires the container runtime to be configured. For more information, see xref:installing-using-podman_cli-guide[Installing the CLI by using Podman].
 
 [source,terminal,subs="attributes+"]
 ----
@@ -65,7 +70,10 @@ You can only use a single target to run the `transform overwrite` command.
 
 == `Rules`
 
-The `rules` subcommand allows converting {LC_PSN} XML rules to analyzer-lsp YAML rules using `windup-shim`.
+You can use the `rules` subcommand of the `transform` command to convert {LC_PSN} XML rules to `analyzer-lsp` YAML rules. To covert rules, the `rules` subcommand uses the `windup-shim` tool.
+
+NOTE: `analyzer-lsp` evaluates the rules for the providers and determines rule matches.
+
 [source,terminal,subs="attributes+"]
 ----
 Convert XML rules to YAML

docs/topics/mta-review-reports.adoc

@@ -6,7 +6,7 @@
 [id="review-reports_{context}"]
 = Reviewing the reports
 
-The report examples shown in the following sections are a result of analyzing the `com.acme` and `org.apache` packages in the https://github.com/windup/windup/blob/master/test-files/jee-example-app-1.0.0.ear[jee-example-app-1.0.0.ear] example application, which is located in the {ProductShortName} GitHub source repository.
+The report examples shown in the following sections are a result of analyzing the `com.acme` and `org.apache` packages in the https://github.com/windup/windup/blob/master/test-files/jee-example-app-1.0.0.ear[jee-example-app-1.0.0.ear] example application.
 
 ifdef::cli-guide[]
 The report was generated using the following command.