CLI guide restrucures/rewrites

Author: Mariya Pershina

assemblies/cli-guide/assembly_analyzing-applications-mta-cli.adoc

@@ -0,0 +1,40 @@
+:_newdoc-version: 2.18.3
+:_template-generated: 2025-03-17
+
+ifdef::context[:parent-context-of-analyzing-applications-mta-cli: {context}]
+
+:_mod-docs-content-type: ASSEMBLY
+
+ifndef::context[]
+[id="analyzing-applications-mta-cli"]
+endif::[]
+ifdef::context[]
+[id="analyzing-applications-mta-cli_{context}"]
+endif::[]
+= Analyzing applications with {ProductShortName} CLI
+
+:context: analyzing-applications-mta-cli
+
+Depending on your scenario, you can use the {ProductFullName} {CLINameTitle} to run the analysis the following ways:
+
+* Run the analysis against a single application.
+* Run the analysis against multiple applications:
+** In {ProductShortName} versions earlier than 7.1.0, you can enter a series of `--analyze` commands, each against an application and each generating a separate report. For more information, see xref:mta-cli-run-single-app_cli-guide[Running the {ProductShortName} {CLINameTitle} against an application].
+** In {ProductShortName} 7.1.0 and later, you can use the `--bulk` option to analyze multiple applications at once and generate a single report. Note that this feature is a Developer Preview feature only. For more information, see xref:mta-cli-run-multiple-apps_cli-guide[Running the {ProductShortName} {CLINameTitle} against multiple applications and generating a single report (Developer Preview)].
+
+IMPORTANT: Starting from {ProductShortName} 7.2.0, you can run the application analysis in the containerless mode. Note that this option is set by default and is used automatically if all requirements are met. For more information, see xref:running-the-containerless-mta-cli_cli-guide[Running the containerless CLI].
+
+
+include::topics/proc_analyzing-single-app-with-mta-cli.adoc[leveloffset=+1]
+ 
+include::topics/proc_analyzing-multiple-apps-with-mta-cli.adoc[leveloffset=+1]
+
+include::topics/proc_running-the-containerless-mta-cli.adoc[leveloffset=+1]
+
+include::topics/ref_mta-cli-analyze-flags.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+
+ifdef::parent-context-of-analyzing-applications-mta-cli[:context: {parent-context-of-analyzing-applications-mta-cli}]
+ifndef::parent-context-of-analyzing-applications-mta-cli[:!context:]
+

assemblies/cli-guide/assembly_analyzing-multi-language-applications.adoc

@@ -0,0 +1,34 @@
+:_newdoc-version: 2.18.3
+:_template-generated: 2025-04-09
+
+ifdef::context[:parent-context-of-analyzing-multi-language-applications: {context}]
+
+:_mod-docs-content-type: ASSEMBLY
+
+ifndef::context[]
+[id="analyzing-multi-language-applications"]
+endif::[]
+ifdef::context[]
+[id="analyzing-multi-language-applications_{context}"]
+endif::[]
+= Analyzing multi-language applications
+
+:context: analyzing-multi-language-applications
+
+Starting from {ProductFullName} 7.1.0, you can run the application analysis on applications written in multiple languages. 
+
+IMPORTANT: Analyzing multi-language applications is only possible in container mode. You can use containerless analysis only for applications written in Java.
+
+You can perform the multi-language application analysis either of the following ways: 
+
+* Select a supported language provider to run the analysis for. 			
+* Overwrite the existing supported language provider with your own unsupported language provider and then run the analysis for it. 	
+
+include::topics/mta-cli-analyze-selected-provider.adoc[leveloffset=+1]
+
+include::topics/mta-cli-analyze-unsupported-provider.adoc[leveloffset=+1]
+
+
+ifdef::parent-context-of-analyzing-multi-language-applications[:context: {parent-context-of-analyzing-multi-language-applications}]
+ifndef::parent-context-of-analyzing-multi-language-applications[:!context:]
+

assemblies/cli-guide/assembly_installing-mta-cli.adoc

@@ -0,0 +1,49 @@
+:_newdoc-version: 2.18.3
+:_template-generated: 2025-03-14
+
+ifdef::context[:parent-context-of-installing-mta-cli: {context}]
+
+:_mod-docs-content-type: ASSEMBLY
+
+ifndef::context[]
+[id="installing-mta-cli"]
+endif::[]
+ifdef::context[]
+[id="installing-mta-cli_{context}"]
+endif::[]
+= Installing MTA CLI
+
+:context: installing-mta-cli
+
+You can install the {ProductFullName} command-line interface (CLI) on Linux, Windows, or macOS operating systems one of the following ways:
+
+* Use the downloadable `.zip` file.
+* Use the Podman tool.
+
+IMPORTANT: Downloading and installing the `.zip` file is the preferred way of installing the {ProductShortName} CLI.
+
+NOTE: You can also install the CLI for use with Docker on Windows. Note, however, that this is a Developer Preview feature only. 	
+
+// Move to the running the CLI section
+////
+[IMPORTANT]
+====
+Starting from {ProductShortName} 7.2.0, you can run the application analysis for Java applications  in the containerless mode.
+
+The containerless mode is set by default and is used automatically if all requirements are met. For more information, see xref:running-the-containerless-mta-cli_cli-guide[Running the containerless CLI].
+
+However, if you want to analyze applications in languages other than Java or, for example, use xref:mta-cli-transform_cli-guide[transformation commands], you still need to use containers.
+====
+////
+
+include::topics/mta-cli/proc_installing-cli-zip.adoc[leveloffset=+1]
+
+include::topics/mta-cli/proc_installing-cli-with-podman.adoc[leveloffset=+1]
+
+include::topics/proc_installing-cli-for-docker.adoc[leveloffset=+1]
+
+
+
+ifdef::parent-context-of-installing-mta-cli[:context: {parent-context-of-installing-mta-cli}]
+ifndef::parent-context-of-installing-mta-cli[:!context:]
+

assemblies/cli-guide/assembly_performing-transformation.adoc

@@ -0,0 +1,35 @@
+:_newdoc-version: 2.18.3
+:_template-generated: 2025-04-08
+
+ifdef::context[:parent-context-of-performing-transformation: {context}]
+
+:_mod-docs-content-type: ASSEMBLY
+
+ifndef::context[]
+[id="performing-transformation"]
+endif::[]
+ifdef::context[]
+[id="performing-transformation_{context}"]
+endif::[]
+= Performing a transformation with the {ProductShortName} CLI
+
+
+:context: performing-transformation
+
+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].
+
+
+include::topics/proc_transforming-application-source-code.adoc[leveloffset=+1]
+
+include::topics/ref_available-openrewrite-recipes.adoc[leveloffset=+1]
+
+include::topics/proc_converting-xml-to-yaml.adoc[leveloffset=+1]
+
+ifdef::parent-context-of-performing-transformation[:context: {parent-context-of-performing-transformation}]
+ifndef::parent-context-of-performing-transformation[:!context:]
+

assemblies/cli-guide/topics

@@ -0,0 +1 @@
+../../topics/

docs/cli-guide/master-docinfo.xml

@@ -1,9 +1,9 @@
 <title>CLI Guide</title>
 <productname>{DocInfoProductName}</productname>
 <productnumber>{DocInfoProductNumber}</productnumber>
-<subtitle>Learn how to use the {ProductName} {CLIName} to migrate your applications.</subtitle>
+<subtitle>Using the {ProductName} command-line interface to migrate applications.</subtitle>
 <abstract>
-    <para>This guide describes how to use the {ProductName} {CLIName} to simplify migration of Java applications.</para>
+    <para>By using the {ProductName} command-line interface (CLI), you can assess and prioritize migration and modernization efforts for Java applications.</para>
 </abstract>
 <authorgroup>
     <orgname>Red Hat Customer Content Services</orgname>

docs/cli-guide/master.adoc

@@ -10,88 +10,29 @@ include::topics/templates/document-attributes.adoc[]
 :imagesdir: topics/images
 :context: cli-guide
 :cli-guide:
-
+ 
 //Inclusive language statement
 include::topics/making-open-source-more-inclusive.adoc[]
 
-== Introduction
-
-// About the {UserCLIBookName}
-include::topics/about-cli-guide.adoc[leveloffset=+2]
-
-:FeatureName: .NET migration
-include::topics/developer-preview-feature.adoc[]
-
-:FeatureName: Analyzing applications written in a language other than Java
-include::topics/developer-preview-feature.adoc[]
-
-// About {ProductName}
-include::topics/mta-what-is-the-toolkit.adoc[leveloffset=+2]
-
-include::topics/migration-paths.adoc[leveloffset=+3]
-
-For more information about use cases and migration paths, see the link:https://developers.redhat.com/products/mta/use-cases[{ProductShortName} for developers] web page.
+include::topics/mta-intro-to-the-cli.adoc[leveloffset=+1]
 
-// About the {CLINameTitle}
-include::topics/about-cli.adoc[leveloffset=+2]
+include::topics/mta-migration-paths.adoc[leveloffset=+1]
 
-== Installing and Running the CLI
-
-// Install the CLI
-include::topics/installing-cli-tool.adoc[leveloffset=+2]
+include::assemblies/cli-guide/assembly_installing-mta-cli.adoc[leveloffset=+1]
 
 // Install in disconnected environment
 include::topics/installing-mta-disconnected-environment.adoc[leveloffset=+2]
 
-// CLI known issues
-include::topics/cli-tool-known-issues.adoc[leveloffset=+3]
-
-[id="running-cli"]
-=== Running the CLI
-
-Depending on your scenario, you can use the {ProductFullName} {CLINameTitle} to run the analysis in the following ways:
-
-* Run the analysis against a single application.
-* Run the analysis against multiple applications:
-** In {ProductShortName} versions earlier than 7.1.0, you can enter a series of `--analyze` commands, each against an application and each generating a separate report. For more information, see xref:mta-cli-run-single-app_cli-guide[Running the {ProductShortName} {CLINameTitle} against an application].
-** In {ProductShortName} 7.1.0 and later, you can use the `--bulk` option to analyze multiple applications at once and generate a single report. Note that this feature is a Developer Preview feature only. For more information, see xref:mta-cli-run-multiple-apps_cli-guide[Running the {ProductShortName} {CLINameTitle} against multiple applications and generating a single report (Developer Preview)].
+include::assemblies/cli-guide/assembly_analyzing-applications-mta-cli.adoc[leveloffset=+1]
 
-//:FeatureName: Running the {CLINameTitle} against one or more applications
-//include::topics/developer-preview-feature.adoc[]
+include::assemblies/cli-guide/assembly_analyzing-multi-language-applications.adoc[leveloffset=+1]
 
-IMPORTANT: Starting from {ProductShortName} 7.2.0, you can run the application analysis in the containerless mode. Note that this option is set by default and is used automatically if all requirements are met. For more information, see xref:running-the-containerless-mta-cli_cli-guide[Running the containerless CLI].
+include::assemblies/cli-guide/assembly_performing-transformation.adoc[leveloffset=+1]
 
-// Run the CLI
-include::topics/mta-cli-run-single-app.adoc[leveloffset=+3]
-
-include::topics/mta-cli-run-multiple-apps.adoc[leveloffset=+3]
-
-// Analyze application source code
-include::topics/mta-cli-analyze.adoc[leveloffset=+3]
-
-include::topics/proc_running-the-containerless-mta-cli.adoc[leveloffset=+3]
-
-// Transform XML rules to YAML
-include::topics/mta-cli-transform.adoc[leveloffset=+3]
-
-// Use OpenRewrite recipes
-// include::topics/mta-using-openrewrite-recipes.adoc[leveloffset=+3]
-
-// Available OpenRewrite recipes
-include::topics/available-openrewrite-recipes.adoc[leveloffset=+4]
 
 // Access the Report
 include::topics/access-report.adoc[leveloffset=+2]
 
-// Multi-language application analysis
-include::topics/mta-cli-analyze-multi-lang-apps.adoc[leveloffset=+2]
-
-// Multi-language application analysis for the supported provider
-include::topics/mta-cli-analyze-selected-provider.adoc[leveloffset=+3]
-
-// Multi-language application analysis for the unsupported provider
-include::topics/mta-cli-analyze-unsupported-provider.adoc[leveloffset=+3]
-
 // Review the Reports
 include::topics/mta-review-reports.adoc[leveloffset=+1]
 
@@ -107,6 +48,9 @@ include::topics/mta-optimize-performance.adoc[leveloffset=+1]
 // Configure {ProductShortName} to Exclude Files and Packages
 // include::topics/mta-exclude-files-and-packages.adoc[leveloffset=+2]
 
+// CLI known issues
+include::topics/cli-tool-known-issues.adoc[leveloffset=+3]
+
 [appendix]
 == Reference material