More rewrites/restructures

Author: Mariya Pershina

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

@@ -11,27 +11,33 @@ endif::[]
 ifdef::context[]
 [id="analyzing-applications-mta-cli_{context}"]
 endif::[]
-= Analyzing applications with {ProductShortName} CLI
+= Analyzing Java 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:
+Depending on your scenario, you can use the {ProductFullName} {CLINameTitle} to perform the following actions:
 
 * 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)].
+** 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:analyzing-single-app-wth-mta-cli_analyzing-applications-mta-cli[Running the {ProductShortName} {CLINameTitle} against an application].
+** In {ProductShortName} version 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:analyzing-multiple-apps-with-mta-cli_analyzing-applications-mta-cli[Analyzing multiple applications].
 
-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].
+[IMPORTANT]
+====
+Starting from {ProductShortName} version 7.2.0, you can run the application analysis for Java applications in the containerless mode. Note that this option is set by default and is used automatically only if all requirements are met. For more information, see xref:running-the-containerless-mta-cli_analyzing-applications-mta-cli[Analyzing an application in the containerless mode].
 
+However, if you want to analyze applications in languages other than Java or, for example, use xref:performing-transformation_cli-guide[transformation commands], you still need to use containers.
+====
 
-include::topics/proc_analyzing-single-app-with-mta-cli.adoc[leveloffset=+1]
+{ProductShortName} CLI supports running source code and binary analysis by using `analyzer-lsp`. `analyzer-lsp` is a tool that evaluates rules by using language providers.
+
+include::topics/mta-cli/proc_analyzing-single-app-with-mta-cli.adoc[leveloffset=+1]
 
-include::topics/proc_analyzing-multiple-apps-with-mta-cli.adoc[leveloffset=+1]
+include::topics/mta-cli/proc_analyzing-multiple-apps-with-mta-cli.adoc[leveloffset=+1]
 
-include::topics/proc_running-the-containerless-mta-cli.adoc[leveloffset=+1]
+include::topics/mta-cli/proc_running-the-containerless-mta-cli.adoc[leveloffset=+1]
 
-include::topics/ref_mta-cli-analyze-flags.adoc[leveloffset=+1]
+include::topics/mta-cli/ref_mta-cli-analyze-flags.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
 

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-nonjava-applications"]
+endif::[]
+ifdef::context[]
+[id="analyzing-nonjava-applications_{context}"]
+endif::[]
+= Analyzing applications written in languages other than Java
+
+:context: analyzing-nonjava-applications
+
+Starting from {ProductFullName} version 7.1.0, you can run the application analysis on applications written in languages other than Java. You can perform the 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. 
+ 
+
+IMPORTANT: Analyzing applications written in languages other than Java is only possible in container mode. You can use containerless CLI only for Java applications. For more information, see xref:running-the-containerless-mta-cli_analyzing-applications-mta-cli[Analyzing an application in containerless mode].
+
+
+include::topics/mta-cli/proc_analyze-selected-provider.adoc[leveloffset=+1]
+
+include::topics/mta-cli/proc_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_analyzing-nonjava-applications.adoc

@@ -0,0 +1,51 @@
+:_newdoc-version: 2.18.3
+:_template-generated: 2025-05-28
+
+ifdef::context[:parent-context-of-generating-assets: {context}]
+
+:_mod-docs-content-type: ASSEMBLY
+
+ifndef::context[]
+[id="generating-assets"]
+endif::[]
+ifdef::context[]
+[id="generating-assets_{context}"]
+endif::[]
+= Generating platform assets for application deployment
+
+:context: generating-assets
+
+Starting from {ProductShortName} version 7.3.0, you can use the `discover` and `generate` commands in containerless mode to automatically generate the manifests needed to deploy a Cloud Foundry (CF) application in the {ocp-short}: 
+
+* The `discover` command generates the discovery manifest in the YAML format from the CF application manifest. The discovery manifest preserves the specifications found in the CF manifest that define the metadata, runtime, and platform configurations.
+* The `generate` command generates the deployment manifest for {ocp} deployments by using the discovery manifest. The deployment manifest is generated by using a templating engine, such as Helm, that converts the discovery manifest into a Kubernetes-native format. You can also use this command to generate non-Kubernetes manifests, such as a Dockerfile or a configuration file.
+
+Generating deployment assets has the following benefits:
+
+* Generating the Kubernetes and non-Kubernetes deployment manifests.   
+* Generating deployment manifests by using familiar template engines, for example, Helm, that are widely used for Kubernetes deployments.
+* Adhering to Kubernetes best practices when preparing the deployment manifest by using Helm templates.
+
+:FeatureName: Generating platform assets for application deployment
+include::topics/snippets/developer-preview-admonition.adoc[]
+
+.Prerequisites
+
+* You have Cloud Foundry (v3) as a source platform.
+* You have {ocp-short} as a target platform. 
+* You have {ProductShortName} {CLIName} version 7.3.0 installed.
+
+
+include::topics/mta-cli/proc_generating-discovery-manifest.adoc[leveloffset=+1]
+
+include::topics/mta-cli/proc_generating-deployment-manifest.adoc[leveloffset=+1]
+ 
+include::topics/mta-cli/ref_discover-generate-command-options.adoc[leveloffset=+1]
+
+include::topics/mta-cli/ref_assets-generation-example.adoc[leveloffset=+1]
+
+
+
+ifdef::parent-context-of-generating-assets[:context: {parent-context-of-generating-assets}]
+ifndef::parent-context-of-generating-assets[:!context:]
+

assemblies/cli-guide/assembly_generating-assets.adoc

@@ -15,33 +15,15 @@ endif::[]
 
 :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:
+You can install the {ProductFullName} command-line interface (CLI) on Linux, Windows, or macOS operating systems. 
 
-* 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.
-====
-////
+NOTE: You can also install the CLI for use with Docker on Windows. Note, however, that this is a Developer Preview feature only. 
 
 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]
+include::topics/mta-cli/proc_installing-cli-for-docker.adoc[leveloffset=+1]
 
+//NEEDS TO BE REWRITTEN YET include::topics/mta-cli/installing-mta-disconnected-environment.adoc[leveloffset=+2]
 
 
 ifdef::parent-context-of-installing-mta-cli[:context: {parent-context-of-installing-mta-cli}]

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

@@ -21,14 +21,14 @@ 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].
+IMPORTANT: Performing transformation requires the container runtime to be configured. 
 
 
-include::topics/proc_transforming-application-source-code.adoc[leveloffset=+1]
+include::topics/mta-cli/proc_transforming-application-source-code.adoc[leveloffset=+1]
 
-include::topics/ref_available-openrewrite-recipes.adoc[leveloffset=+1]
+include::topics/mta-cli/ref_available-openrewrite-recipes.adoc[leveloffset=+1]
 
-include::topics/proc_converting-xml-to-yaml.adoc[leveloffset=+1]
+include::topics/mta-cli/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/assembly_performing-transformation.adoc

@@ -0,0 +1,34 @@
+:_newdoc-version: 2.18.3
+:_template-generated: 2025-05-28
+
+ifdef::context[:parent-context-of-reference-material: {context}]
+
+:_mod-docs-content-type: ASSEMBLY
+
+ifndef::context[]
+[id="reference-material"]
+endif::[]
+ifdef::context[]
+[id="reference-material_{context}"]
+[appendix,id="reference-material"]
+endif::[]
+= Reference material
+
+:context: reference-material
+
+The following is information that you might find useful when using the {ProductFullName} CLI. 
+
+// {ProductShortName} Command-line Arguments
+//include::topics/mta-cli-args.adoc[leveloffset=+2]
+
+// Added in 4.3.0: list of supported Tech Tags
+include::topics/ref_mta-tech-tags.adoc[leveloffset=+1]
+
+// Rule Story Points
+include::assembly_rule-story-points.adoc[leveloffset=+1]
+
+
+
+ifdef::parent-context-of-reference-material[:context: {parent-context-of-reference-material}]
+ifndef::parent-context-of-reference-material[:!context:]
+

assemblies/cli-guide/assembly_reference-material.adoc

@@ -0,0 +1,34 @@
+:_newdoc-version: 2.18.3
+:_template-generated: 2025-04-10
+
+ifdef::context[:parent-context-of-reviewing-analysis-reports: {context}]
+
+:_mod-docs-content-type: ASSEMBLY
+
+ifndef::context[]
+[id="reviewing-analysis-reports"]
+endif::[]
+ifdef::context[]
+[id="reviewing-analysis-reports_{context}"]
+endif::[]
+= Reviewing analysis reports
+
+:context: reviewing-analysis-reports
+
+When you run an application analysis, the {ProductFullName} CLI generates an analysis report in the output directory that you specify by using the `--output` argument in the `mta-cli analyze` command.
+
+The output directory contains the following files and subdirectories: 	
+
+* analysis.log
+* dependencies.yaml
+* output.yaml
+* shim.log
+* static-report
+* static-report.log
+
+
+
+
+ifdef::parent-context-of-reviewing-analysis-reports[:context: {parent-context-of-reviewing-analysis-reports}]
+ifndef::parent-context-of-reviewing-analysis-reports[:!context:]
+

assemblies/cli-guide/assembly_reviewing-analysis-reports.adoc

@@ -0,0 +1,29 @@
+:_newdoc-version: 2.18.3
+:_template-generated: 2025-05-28
+
+ifdef::context[:parent-context-of-rule-story-points: {context}]
+
+:_mod-docs-content-type: ASSEMBLY
+
+ifndef::context[]
+[id="rule-story-points"]
+endif::[]
+ifdef::context[]
+[id="rule-story-points_{context}"]
+endif::[]
+= Rule story points
+
+:context: rule-story-points
+
+_Story points_ are an abstract metric commonly used in Agile software development to estimate the level of effort required to implement a feature or change.
+
+The {ProductName} uses story points to express the level of effort needed to migrate particular application constructs, and the application as a whole. It does not necessarily translate to man-hours, but the value must be consistent across tasks.
+
+include::topics/ref_effort-level-estimation.adoc[leveloffset=+1]
+
+include::topics/ref_migration-tasks-categories.adoc[leveloffset=+1]
+
+
+ifdef::parent-context-of-rule-story-points[:context: {parent-context-of-rule-story-points}]
+ifndef::parent-context-of-rule-story-points[:!context:]
+