stolostron/backlog#11273 -- rename

Author: swopebe

SECURITY.md

@@ -2,4 +2,4 @@
 
 If you found a security issue that you want to disclose confidentially, contact Red Hat's Product Security team.
 
-For more details, see [Security Contacts and Procedures](https://access.redhat.com/security/team/contact).
+For more details, see [Security Contacts and Procedures](https://access.redhat.com/risk_compliance/team/contact).

about/architecture.adoc

@@ -30,7 +30,7 @@ The hub cluster aggregates information from multiple clusters by using an asynch
 
 The _managed_ cluster is the term that is used to define additional clusters that are managed by the hub cluster. The connection between the two is completed by using the _Klusterlet_, which is the agent that is installed on the managed cluster. The managed cluster receives and applies requests from the hub cluster and enables it to service cluster lifecycle, application lifecycle, governanace and risk, and observability on the managed cluster. 
 
-For example, managed clusters send metrics to the hub cluster if the observability service is enabled. See link:../observing_environments/observe_environments.adoc#observing-environments[Observing environments] to receive metrics and optimize the health of all managed clusters.
+For example, managed clusters send metrics to the hub cluster if the observability service is enabled. See link:../observability/observe_environments.adoc#observing-environments[Observing environments] to receive metrics and optimize the health of all managed clusters.
 
 [#cluster-lifecycle]
 == Cluster lifecycle
@@ -39,7 +39,7 @@ For example, managed clusters send metrics to the hub cluster if the observabili
 
 From the hub cluster console, you can view an aggregation of all cluster health statuses, or view individual health metrics of many Kubernetes clusters. Additionally, you can upgrade managed {ocp-short} clusters individually or in bulk, as well as destroy any {ocp-short} clusters that you created using your hub cluster.
 
-See link:../manage_cluster/intro.adoc#managing-your-clusters[Managing your clusters] to learn about managing clusters, which is part of _Cluster lifecycle_.
+See link:../clusters/intro.adoc#managing-your-clusters[Managing your clusters] to learn about managing clusters, which is part of _Cluster lifecycle_.
 
 [#application-lifecycle]
 == Application lifecycle
@@ -48,22 +48,22 @@ See link:../manage_cluster/intro.adoc#managing-your-clusters[Managing your clust
 
 A multicluster application uses the Kubernetes specification, but provides additional automation of the deployment and lifecycle management of resources. As a technology preview function, the integration of Ansible Tower jobs enables scheduling automated tasks.  
 
-See link:../manage_applications/app_management_overview.adoc#managing-applications[Managing applications] for more application topics.
+See link:../applications/app_management_overview.adoc#managing-applications[Managing applications] for more application topics.
 
 [#governance-and-risk]
 == Governance and risk
 
 _Governance and risk_ enables you to define policies that either enforce security compliance, or alert you of changes that violate the configured compliance requirements for your environment. You can manage the policies and compliance requirements across all of your management clusters from a central interface page.
 After you configure a {product-title-short} hub cluster and a managed cluster, you can view and create policies with the {product-title-short} policy framework. You can take advantage of the https://github.com/open-cluster-management/policy-collection/tree/master/community[`policy-collection` community] to see what policies community members created and contributed, as well as contribute your own policies for others to use. 
 
-For more information about Governance and risk, see the link:../security/security_intro.adoc#security[Security] introduction. Additionally, learn about access requirements from the link:../security/rbac.adoc#role-based-access-control[Role-based access control] documentation.
+For more information about Governance and risk, see the link:../risk_compliance/security_intro.adoc#security[Security] introduction. Additionally, learn about access requirements from the link:../risk_compliance/rbac.adoc#role-based-access-control[Role-based access control] documentation.
 
 [#observability-arch]
 == Observability
 
 The _Observability_ component collects and reports the status and health of the {ocp-short} version 4.x, or later, managed clusters to the hub cluster. You can create custom alerts to inform you of problems with your fleet of managed clusters. Because it requires configured persistent storage, observability must be enabled after the {product-title-short} installation.  
 
-For more information about Observability, see link:../observing_environments/observe_environments_intro.adoc#observing-environments-intro[Observing environments introduction].
+For more information about Observability, see link:../observability/observe_environments_intro.adoc#observing-environments-intro[Observing environments introduction].
 
 See the product link:../install/install_overview.adoc#installing[Installing] section to prepare your cluster and get configuration information.
 

about/quick_start.adoc

@@ -13,7 +13,7 @@
 
 See the product architecture at xref:../about/architecture.adoc#multicluster-architecture[Multicluster architecture].  
 
-After you learn about the hub cluster and managed cluster architecture, learn about the link:../manage_cluster/supported_clouds.adoc#supported-clouds[Supported clouds], which lists the cloud provider cluster options.
+After you learn about the hub cluster and managed cluster architecture, learn about the link:../clusters/supported_clouds.adoc#supported-clouds[Supported clouds], which lists the cloud provider cluster options.
 
 The hub cluster is a {ocp} cluster version 4.5, 4.6, or 4.7 and can run on any https://docs.openshift.com/container-platform/4.7/architecture/architecture-installation.html[supported {ocp} infrastructure].
 
@@ -39,9 +39,9 @@ After installation, review the link:../console/console_intro.adoc#web-console[We
 You are now ready to create and import clusters.
 From your hub cluster, you can create clusters from other Kubernetes services to manage, and you can view cluster information.
 
-. See link:../manage_cluster/create.adoc#creating-a-cluster[Creating a cluster] to learn about the types of managed clusters you can create.
+. See link:../clusters/create.adoc#creating-a-cluster[Creating a cluster] to learn about the types of managed clusters you can create.
 When you create a managed cluster, the new managed cluster imports automatically.
-. If you have a cluster that you want to import manually, you can view link:../manage_cluster/import.adoc#importing-a-target-managed-cluster-to-the-hub-cluster[Importing a target managed cluster to the hub cluster] to learn how to import a managed cluster.
+. If you have a cluster that you want to import manually, you can view link:../clusters/import.adoc#importing-a-target-managed-cluster-to-the-hub-cluster[Importing a target managed cluster to the hub cluster] to learn how to import a managed cluster.
 . When you no longer need to manage a cluster, you can detach that cluster from the _Cluster page_.
 
 [#manage-applications]
@@ -50,7 +50,7 @@ When you create a managed cluster, the new managed cluster imports automatically
 You can start managing applications on any created and imported managed clusters.
 The types of resources that you can create are applications, channels, subscriptions, and placement rules.
 
-. Learn more about the resources and how to create and manage them at link:../manage_applications/app_management_overview.adoc#managing-applications[Managing applications].
+. Learn more about the resources and how to create and manage them at link:../applications/app_management_overview.adoc#managing-applications[Managing applications].
 Add or edit your `.yaml` file to create your resources.
 . View and edit your resources from the _Applications Dashboard_.
 
@@ -60,7 +60,7 @@ Add or edit your `.yaml` file to create your resources.
 You can also manage security and compliance across your created and imported managed clusters.
 
 . Create a policy using the _policy_ templates.
-See the link:../security/policy_example.adoc#policy-overview[Policy overview] for details about how to create a policy with a `.yaml` file template.
+See the link:../risk_compliance/policy_example.adoc#policy-overview[Policy overview] for details about how to create a policy with a `.yaml` file template.
 . From the _Policies_ page, you can view a summary of cluster and policy violations.
 . View your policies from the _Governance and risk_ page in the console.
 You can also view policy details from the cluster _Overview_.
@@ -70,5 +70,5 @@ You can also view policy details from the cluster _Overview_.
 
 You can enable the observability service to gain insight and optimize your managed clusters. Enable the observability service operator (`multicluster-observability-operator`) to monitor the health of your managed clusters.
 
-. Learn more about link:../observing_environments/observe_environments.adoc#observing-environments[Observing environments] and how to link:../observing_environments/observability_enable.adoc#enable-observability[Enable observability service].
-. Learn about link:../observing_environments/customize_observability.adoc#customizing-observability[Customizing observability].
+. Learn more about link:../observability/observe_environments.adoc#observing-environments[Observing environments] and how to link:../observability/observability_enable.adoc#enable-observability[Enable observability service].
+. Learn about link:../observability/customize_observability.adoc#customizing-observability[Customizing observability].

apis/api.adoc

@@ -3,7 +3,7 @@
 
 You can access APIs to create and manage application resources, channels, subscriptions, and to query information.
 
-*User required access:* You can only perform actions that your role is assigned. Learn about access requirements from the link:../security/rbac.adoc#role-based-access-control[Role-based access control] documentation. 
+*User required access:* You can only perform actions that your role is assigned. Learn about access requirements from the link:../risk_compliance/rbac.adoc#role-based-access-control[Role-based access control] documentation. 
 
 For more information, review the API documentation for each of the following resources:
 

manage_applications/ansible_config.adoc renamed to applications/ansible_config.adoc

@@ -0,0 +1,22 @@
+[#application-advanced-configuration]
+= Application advanced configuration
+
+Within {product-title}, applications are composed of multiple application resources. You can use channel, subscription, and placement rule resources to help you deploy, update, and manage your overall applications.
+
+Both single and multicluster applications use the same Kubernetes specifications, but multicluster applications involve more automation of the deployment and application management lifecycle.
+
+All of the application component resources for {product-title} applications are defined in YAML file spec sections.
+When you need to create or update an application component resource, you need to create or edit the appropriate spec section to include the labels for defining your resource.
+
+View the following application advanced configuration topics:
+
+
+* xref:../applications/subscribe_git_resources.adoc#subscribing-git-resources[Subscribing Git resources] 
+* xref:../applications/configuring_git_channel.adoc#configuring-git-channel[Configuring application channel and subscription for a secure Git connection] 
+* xref:../applications/ansible_config.adoc#setting-up-ansible[Setting up Ansible Tower tasks]
+* xref:../applications/config_argo.adoc#configuring-argo[Configuring managed clusters for Argo CD]
+* xref:../applications/package_overrides.adoc#configuring-package-overrides[Configuring package overrides]
+* xref:../applications/channel_sample.adoc#channel-samples[Channel samples]
+* xref:../applications/subscription_sample.adoc#subscription-samples[Subscription samples]
+* xref:../applications/placement_sample.adoc#placement-rule-samples[Placement rule samples]
+* xref:../applications/app_sample.adoc#application-samples[Application samples]

applications/app_advanced_config.adoc

@@ -5,7 +5,7 @@ The console includes a dashboard for managing the application lifecycle. You can
 
 See the following application console capabilities:
 
-*Important:* Actions are based on your assigned role. Learn about access requirements from the link:../security/rbac.adoc#role-based-access-control[Role-based access control] documentation.
+*Important:* Actions are based on your assigned role. Learn about access requirements from the link:../risk_compliance/rbac.adoc#role-based-access-control[Role-based access control] documentation.
 
 * Visualize deployed applications across your clusters, including any associated resource repositories, subscriptions, and placement configurations.
 
@@ -63,7 +63,7 @@ The topology provides a visual representation of the application that was select
 **Notes:** The cluster CPU and memory percentage that is displayed is the percentage that is currently utilized. This value is rounded down, so a very small value might display as `0`.
 
 +
-For Helm subscriptions, see link:../manage_applications/package_overrides.adoc#configuring-package-overrides[Configuring package overrides] to define the appropriate `packageName` and the `packageAlias` to get an accurate topology display.
+For Helm subscriptions, see link:../applications/package_overrides.adoc#configuring-package-overrides[Configuring package overrides] to define the appropriate `packageName` and the `packageAlias` to get an accurate topology display.
 +
 
 * View a successful Ansible Tower deployment if you are using Ansible tasks as prehook or posthook for the deployed application. 

manage_applications/app_console.adoc renamed to applications/app_console.adoc

@@ -0,0 +1,27 @@
+[#managing-applications]
+= Managing applications
+
+Review the following topics to learn more about creating, deploying, and managing your applications. This guide assumes familiarity with Kubernetes concepts and terminology.
+Key Kubernetes terms and components are not defined. For more information about Kubernetes concepts, see https://kubernetes.io/docs/home/[Kubernetes Documentation].
+
+The application management functions provide you with unified and simplified options for constructing and deploying applications and application updates. With these functions, your developers and DevOps personnel can create and manage applications across environments through channel and subscription-based automation.
+
+See the following topics:
+
+* xref:../applications/app_model.adoc#application-model-and-definitions[Application model and definitions]
+* xref:../applications/app_console.adoc#application-console[Application console]
+* xref:../applications/app_resources.adoc#managing-application-resources[Managing application resources] 
+* xref:../applications/manage_apps_git.adoc#managing-apps-with-git-repositories[Managing apps with Git repositories]
+* xref:../applications/manage_apps_helm.adoc#managing-apps-with-helm-cluster-repositories[Managing apps with Helm repositories]
+* xref:../applications/manage_apps_object.adoc#managing-apps-with-object-storage-repositories[Managing apps with Object storage repositories]
+* xref:../applications/app_advanced_config.adoc#application-advanced-configuration[Application advanced configuration]
+* xref:../applications/subscribe_git_resources.adoc#subscribing-git-resources[Subscribing Git resources]
+* xref:../applications/configuring_git_channel.adoc#configuring-git-channel[Configuring application channel and subscription for a secure Git connection]
+* xref:../applications/ansible_config.adoc#setting-up-ansible[Setting up Ansible Tower tasks] 
+* xref:../applications/config_argo.adoc#configuring-argo[Configuring managed clusters for Argo CD]
+* xref:../applications/scheduling_deployment.adoc#scheduling-a-deployment[Scheduling a deployment]
+* xref:../applications/package_overrides.adoc#configuring-package-overrides[Configuring package overrides]
+* xref:../applications/channel_sample.adoc#channel-samples[Channel samples]
+* xref:../applications/subscription_sample.adoc#subscription-samples[Subscription samples]
+* xref:../applications/placement_sample.adoc#placement-rule-samples[Placement rule samples]
+* xref:../applications/app_sample.adoc#application-samples[Application samples]

applications/app_management_overview.adoc

@@ -54,15 +54,15 @@ Placement rules (`placementrule.apps.open-cluster-management.io`) define the tar
 
 Learn more from the following documentation:
 
-* xref:../manage_applications/app_console.adoc#application-console[Application console]
-* xref:../manage_applications/app_resources.adoc#managing-application-resources[Managing application resources] 
-* xref:../manage_applications/manage_apps_git.adoc#managing-apps-with-git-repositories[Managing apps with Git repositories]
-* xref:../manage_applications/manage_apps_helm.adoc#managing-apps-with-helm-cluster-repositories[Managing apps with Helm repositories]
-* xref:../manage_applications/manage_apps_object.adoc#managing-apps-with-object-storage-repositories[Managing apps with Object storage repositories]
-* xref:../manage_applications/app_advanced_config.adoc#application-advanced-configuration[Application advanced configuration]
-* xref:../manage_applications/subscribe_git_resources.adoc#subscribing-git-resources[Subscribing Git resources] 
-* xref:../manage_applications/ansible_config.adoc#setting-up-ansible[Setting up Ansible Tower tasks] 
-* xref:../manage_applications/channel_sample.adoc#channel-samples[Channel samples]
-* xref:../manage_applications/subscription_sample.adoc#subscription-samples[Subscription samples]
-* xref:../manage_applications/placement_sample.adoc#placement-rule-samples[Placement rule samples]
-* xref:../manage_applications/app_sample.adoc#application-samples[Application samples]
+* xref:../applications/app_console.adoc#application-console[Application console]
+* xref:../applications/app_resources.adoc#managing-application-resources[Managing application resources] 
+* xref:../applications/manage_apps_git.adoc#managing-apps-with-git-repositories[Managing apps with Git repositories]
+* xref:../applications/manage_apps_helm.adoc#managing-apps-with-helm-cluster-repositories[Managing apps with Helm repositories]
+* xref:../applications/manage_apps_object.adoc#managing-apps-with-object-storage-repositories[Managing apps with Object storage repositories]
+* xref:../applications/app_advanced_config.adoc#application-advanced-configuration[Application advanced configuration]
+* xref:../applications/subscribe_git_resources.adoc#subscribing-git-resources[Subscribing Git resources] 
+* xref:../applications/ansible_config.adoc#setting-up-ansible[Setting up Ansible Tower tasks] 
+* xref:../applications/channel_sample.adoc#channel-samples[Channel samples]
+* xref:../applications/subscription_sample.adoc#subscription-samples[Subscription samples]
+* xref:../applications/placement_sample.adoc#placement-rule-samples[Placement rule samples]
+* xref:../applications/app_sample.adoc#application-samples[Application samples]

manage_applications/app_model.adoc renamed to applications/app_model.adoc

@@ -0,0 +1,12 @@
+[#managing-application-resources]
+= Managing application resources
+
+From the console, you can create applications by using Git repositories, Helm repositories, and Object storage repositories.
+
+**Important:** Git Channels can share a namespace with all other channel types: Helm, Object storage, and other Git namespaces.
+
+See the following topics to start managing apps:
+
+* xref:../applications/manage_apps_git.adoc#managing-apps-with-git-repositories[Managing apps with Git repositories]
+* xref:../applications/manage_apps_helm.adoc#managing-apps-with-helm-cluster-repositories[Managing apps with Helm repositories]
+* xref:../applications/manage_apps_object.adoc#managing-apps-with-object-storage-repositories[Managing apps with Object storage repositories]