[OSDOCS-3599] OSD Restructure

Author: EricPonvelle

_topic_maps/_topic_map_osd.yml

@@ -32,16 +32,40 @@ Topics:
   File: legal-notice
   Distros: openshift-dedicated
 ---
-Name: Architecture
+Name: Introduction to OpenShift Dedicated
 Dir: osd_architecture
 Distros: openshift-dedicated
 Topics:
-- Name: Introduction to OpenShift Dedicated
+- Name: Understanding OpenShift Dedicated
   File: osd-understanding
 - Name: Architecture concepts
   File: osd-architecture
+- Name: Policies and service definition
+  Dir: osd_policy
+  Distros: openshift-dedicated
+  Topics:
+    - Name: OpenShift Dedicated service definition
+      File: osd-service-definition
+    - Name: Responsibility assignment matrix
+      File: policy-responsibility-matrix
+    - Name: Understanding process and security for OpenShift Dedicated
+      File: policy-process-security
+    - Name: About availability for OpenShift Dedicated
+      File: policy-understand-availability
+    - Name: Update life cycle
+      File: osd-life-cycle
+- Name: Support for OpenShift Dedicated
+  File: osd-support
+  Distros: openshift-dedicated
 ---
-Name: Planning
+Name: Red Hat OpenShift Cluster Manager
+Dir: ocm
+Distros: openshift-dedicated
+Topics:
+- Name: Red Hat OpenShift Cluster Manager
+  File: ocm-overview
+---
+Name: Planning your environment
 Dir: osd_planning
 Distros: openshift-dedicated
 Topics:
@@ -51,45 +75,71 @@ Topics:
   File: gcp-ccs
 ---
 Name: Getting started
-Dir: osd_quickstart
+Dir: osd_getting_started
 Distros: openshift-dedicated
 Topics:
+- Name: Understanding your cloud deployment options
+  File: osd-understanding-your-cloud-deployment-options
 - Name: Getting started with OpenShift Dedicated
-  File: osd-quickstart
+  File: osd-getting-started
 ---
-Name: Red Hat OpenShift Cluster Manager
-Dir: ocm
+Name: Installing, accessing, and deleting OpenShift Dedicated clusters
+Dir: osd_install_access_delete_cluster
 Distros: openshift-dedicated
 Topics:
-- Name: Red Hat OpenShift Cluster Manager
-  File: ocm-overview
----
-Name: Creating a cluster
-Dir: osd_cluster_create
-Distros: openshift-dedicated
-Topics:
-- Name: Understanding your cloud deployment options
-  File: osd-understanding-your-cloud-deployment-options
 - Name: Creating a cluster on AWS
   File: creating-an-aws-cluster
 - Name: Creating a cluster on GCP
   File: creating-a-gcp-cluster
----
-Name: Configuring identity providers
-Dir: identity_providers
-Distros: openshift-dedicated
-Topics:
 - Name: Configuring your identity providers
   File: config-identity-providers
+- Name: Notifications for OpenShift Dedicated clusters
+  File: notifications
 ---
-Name: Administering your cluster
-Dir: administering_a_cluster
+Name: Cluster administration
+Dir: osd_cluster_admin
 Distros: openshift-dedicated
 Topics:
 - Name: Managing administration roles and users
   File: osd-admin-roles
+- Name: Configuring private connections
+  Dir: osd_private_connections
+  Distros: openshift-dedicated
+  Topics:
+    - Name: Configuring private connections for AWS
+      File: aws-private-connections
+    - Name: Configuring a private cluster
+      File: private-cluster
+- Name: Nodes
+  Dir: osd_nodes
+  Distros: openshift-dedicated
+  Topics:
+    - Name: About machine pools
+      File: osd-nodes-machinepools-about
+    - Name: Managing compute nodes
+      File: osd-managing-worker-nodes
+    - Name: About autoscaling nodes on a cluster
+      File: osd-nodes-about-autoscaling-nodes
+- Name: Monitoring user-defined projects
+  Dir: osd_monitoring
+  Distros: openshift-dedicated
+  Topics:
+    - Name: Understanding the monitoring stack
+      File: osd-understanding-the-monitoring-stack
+    - Name: Configuring the monitoring stack
+      File: osd-configuring-the-monitoring-stack
+    - Name: Accessing monitoring for user-defined projects
+      File: osd-accessing-monitoring-for-user-defined-projects
+    - Name: Managing metrics
+      File: osd-managing-metrics
+    - Name: Managing alerts
+      File: osd-managing-alerts
+    - Name: Reviewing monitoring dashboards
+      File: osd-reviewing-monitoring-dashboards
+    - Name: Troubleshooting monitoring issues
+      File: osd-troubleshooting-monitoring-issues
 ---
-Name: Authentication and authorization
+Name: Cluster security
 Dir: authentication
 Distros: openshift-dedicated
 Topics:
@@ -107,13 +157,6 @@ Topics:
   File: osd-upgrades
   Distros: openshift-dedicated
 ---
-Name: Cluster notifications
-Dir: osd_notifications
-Distros: openshift-dedicated
-Topics:
-- Name: Notifications for OpenShift Dedicated clusters
-  File: notifications
----
 Name: Add-on services
 Dir: adding_service_cluster
 Distros: openshift-dedicated
@@ -124,14 +167,16 @@ Topics:
   File: available-services
   Distros: openshift-dedicated
 ---
-Name: Configuring private connections
-Dir: osd_private_connections
+Name: Storage
+Dir: storage
 Distros: openshift-dedicated
 Topics:
-- Name: Configuring private connections for AWS
-  File: aws-private-connections
-- Name: Configuring a private cluster
-  File: private-cluster
+- Name: Persistent storage
+  Dir: persistent_storage
+  Distros: openshift-dedicated
+  Topics:
+    - Name: Persistent storage using AWS EFS
+      File: osd-persistent-storage-aws
 ---
 Name: Networking
 Dir: networking
@@ -147,47 +192,6 @@ Topics:
 - Name: CIDR range definitions
   File: cidr-range-definitions
 ---
-Name: Nodes
-Dir: nodes
-Distros: openshift-dedicated
-Topics:
-- Name: About machine pools
-  File: nodes-machinepools-about
-- Name: Managing compute nodes
-  File: rosa-managing-worker-nodes
-- Name: About autoscaling nodes on a cluster
-  File: nodes-about-autoscaling-nodes
----
-Name: Monitoring user-defined projects
-Dir: monitoring
-Distros: openshift-dedicated
-Topics:
-- Name: Understanding the monitoring stack
-  File: osd-understanding-the-monitoring-stack
-- Name: Configuring the monitoring stack
-  File: osd-configuring-the-monitoring-stack
-- Name: Accessing monitoring for user-defined projects
-  File: osd-accessing-monitoring-for-user-defined-projects
-- Name: Managing metrics
-  File: osd-managing-metrics
-- Name: Managing alerts
-  File: osd-managing-alerts
-- Name: Reviewing monitoring dashboards
-  File: osd-reviewing-monitoring-dashboards
-- Name: Troubleshooting monitoring issues
-  File: osd-troubleshooting-monitoring-issues
----
-Name: Storage
-Dir: storage
-Distros: openshift-dedicated
-Topics:
-- Name: Persistent storage
-  Dir: persistent_storage
-  Distros: openshift-dedicated
-  Topics:
-    - Name: Persistent storage using AWS EFS
-      File: osd-persistent-storage-aws
----
 Name: Applications
 Dir: applications
 Distros: openshift-dedicated
@@ -199,21 +203,6 @@ Topics:
     - Name: Configuring custom domains for applications
       File: osd-config-custom-domains-applications
 ---
-Name: Policies and service definition
-Dir: osd_policy
-Distros: openshift-dedicated
-Topics:
-- Name: OpenShift Dedicated service definition
-  File: osd-service-definition
-- Name: Responsibility assignment matrix
-  File: policy-responsibility-matrix
-- Name: Understanding process and security for OpenShift Dedicated
-  File: policy-process-security
-- Name: About availability for OpenShift Dedicated
-  File: policy-understand-availability
-- Name: Update life cycle
-  File: osd-life-cycle
----
 Name: Serverless
 Dir: serverless
 Distros: openshift-dedicated
@@ -363,13 +352,10 @@ Topics:
   - Name: Functions development reference guide
     File: serverless-functions-reference-guide
 ---
-Name: Support
-Dir: support
+Name: Troubleshooting
+Dir: osd_support
 Distros: openshift-dedicated
 Topics:
-- Name: Getting support
-  File: getting-support
-  Distros: openshift-dedicated
 - Name: Remote health monitoring with connected clusters
   Dir: remote_health_monitoring
   Distros: openshift-dedicated
@@ -383,7 +369,7 @@ Topics:
   - Name: Using Insights to identify issues with your cluster
     File: using-insights-to-identify-issues-with-your-cluster
 - Name: Summarizing cluster specifications
-  File: summarizing-cluster-specifications
+  File: osd-summarizing-cluster-specifications
   Distros: openshift-dedicated
 - Name: OpenShift Dedicated managed resources
   File: osd-managed-resources

images/osd-nodes-machinepools-about-f7619.png

@@ -1,6 +1,6 @@
 // Module included in the following assemblies:
 //
-// * osd_quickstart/osd-quickstart.adoc
+// * osd_getting_started/osd-getting-started.adoc
 // * identity_providers/config-identity-providers.adoc
 
 :_content-type: PROCEDURE

modules/access-cluster.adoc

@@ -1,6 +1,6 @@
 // Module included in the following assemblies:
 //
-// * osd_quickstart/osd-quickstart.adoc
+// * osd_getting_started/osd-getting-started.adoc
 
 :_content-type: PROCEDURE
 [id="config-idp_{context}"]

modules/config-idp.adoc

@@ -1,7 +1,7 @@
 
 // Module included in the following assemblies:
 //
-// * osd_quickstart/osd-quickstart.adoc
+// * osd_getting_started/osd-getting-started.adoc
 
 :_content-type: PROCEDURE
 [id="deleting-cluster_{context}"]

modules/deleting-cluster.adoc

@@ -1,7 +1,7 @@
 // Module included in the following assemblies:
 //
 // * rosa_getting_started/rosa-getting-started.adoc
-// * osd_quickstart/osd-quickstart.adoc
+// * osd_getting_started/osd-getting-started.adoc
 
 :_content-type: PROCEDURE
 [id="deploy-app_{context}"]

modules/deploy-app.adoc

@@ -1,6 +1,6 @@
 // Module included in the following assemblies:
 //
-// * osd_quickstart/osd-quickstart.adoc
+// * osd_getting_started/osd-getting-started.adoc
 // * osd_cluster_create/creating-an-aws-cluster.adoc
 // * osd_cluster_create/creating-a-gcp-cluster.adoc
 

modules/osd-create-cluster-ccs.adoc

@@ -1,6 +1,6 @@
 // Module included in the following assemblies:
 //
-// * osd_quickstart/osd-quickstart.adoc
+// * osd_getting_started/osd-getting-started.adoc
 // * osd_cluster_create/creating-an-aws-cluster.adoc
 // * osd_cluster_create/creating-a-gcp-cluster.adoc
 

modules/osd-create-cluster-red-hat-account.adoc

@@ -4,7 +4,7 @@
 // * assemblies/osd-architecture.adoc
 
 [id="osd-intro_{context}"]
-= Introduction to {product-title}
+= An overview of {product-title}
 
 {product-title} is professionally managed by Red Hat and hosted on {AWS} or {GCP}. Each {product-title} cluster comes with a fully managed link:https://access.redhat.com/documentation/en-us/openshift_container_platform/4.7/html/architecture/control-plane[control plane] (Control and Infrastructure nodes), application nodes, installation and management by Red Hat Site Reliability Engineers (SRE), premium Red Hat Support, and cluster services such as logging, metrics, monitoring, notifications portal, and a cluster portal.
 

modules/osd-intro.adoc

@@ -1,6 +1,6 @@
 // Module included in the following assemblies:
 //
-// * osd_quickstart/osd-quickstart.adoc
+// * osd_getting_started/osd-getting-started.adoc
 
 :_content-type: PROCEDURE
 [id="scaling-cluster_{context}"]

modules/scaling-cluster.adoc

@@ -32,7 +32,7 @@ Automatic upgrade policies are optional and if they are not set, the upgrade pol
 [id="upgrade-manual_upgrades_{context}"]
 == Manual upgrades
 
-If you opt for manual upgrades, you are responsible for updating your cluster. If your cluster version falls too far behind, it will transition to a limited support status. For more information on OpenShift life cycle policies, see xref:../osd_policy/osd-life-cycle.adoc#osd-life-cycle[{product-title} update life cycle].
+If you opt for manual upgrades, you are responsible for updating your cluster. If your cluster version falls too far behind, it will transition to a limited support status. For more information on OpenShift life cycle policies, see xref:../osd_architecture/osd_policy/osd-life-cycle.adoc#osd-life-cycle[{product-title} update life cycle].
 
 [id="upgrade-notifications_{context}"]
 == Upgrade notifications

modules/upgrade.adoc

@@ -29,7 +29,7 @@ ifdef::openshift-rosa[]
 For information about standard installation prerequisites, see xref:../rosa_install_access_delete_clusters/rosa_getting_started_iam/rosa-aws-prereqs.adoc#prerequisites[AWS prerequisites for ROSA]. For information about the prerequisites for installation using AWS Security Token Service (STS), see xref:../rosa_planning/rosa-sts-aws-prereqs.adoc#rosa-sts-aws-prerequisites[AWS prerequisites for ROSA with STS].
 endif::[]
 ifdef::openshift-dedicated[]
-For more information, see xref:../osd_quickstart/osd-quickstart.adoc#osd-getting-started[Getting started with {product-title}] for a basic cluster installation workflow.
+For more information, see xref:../osd_getting_started/osd-getting-started.adoc#osd-getting-started[Getting started with {product-title}] for a basic cluster installation workflow.
 endif::[]
 
 //OSDOCS-3290 Transparent Proxy Update

networking/configuring-cluster-wide-proxy.adoc

@@ -0,0 +1,23 @@
+:_content-type: ASSEMBLY
+[id="osd-getting-support"]
+= Getting support
+include::_attributes/common-attributes.adoc[]
+ifdef::openshift-dedicated[]
+include::_attributes/attributes-openshift-dedicated.adoc[]
+endif::[]
+:context: osd-getting-support
+
+toc::[]
+
+Get support for {product-title}.
+
+include::modules/support.adoc[leveloffset=+1]
+include::modules/support-knowledgebase-about.adoc[leveloffset=+1]
+include::modules/support-knowledgebase-search.adoc[leveloffset=+1]
+include::modules/support-submitting-a-case.adoc[leveloffset=+1]
+
+[id="osd-getting-support-additional-resources"]
+[role="_additional-resources"]
+== Additional resources
+
+* For details about identifying issues with your cluster, see xref:../osd_support/remote_health_monitoring/using-insights-to-identify-issues-with-your-cluster.adoc#using-insights-to-identify-issues-with-your-cluster[Using Insights to identify issues with your cluster].

osd_architecture/osd-support.adoc

@@ -1,6 +1,6 @@
 :_content-type: ASSEMBLY
 [id="osd-understanding"]
-= Introduction to {product-title}
+= Understanding {product-title}
 include::_attributes/attributes-openshift-dedicated.adoc[]
 :context: osd-understanding
 
@@ -13,4 +13,4 @@ include::modules/osd-intro.adoc[leveloffset=+1]
 [role="_additional-resources"]
 .Additional resources
 
-* For more information about Telemetry and remote health monitoring for {product-title} clusters, see xref:../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring]
+* For more information about Telemetry and remote health monitoring for {product-title} clusters, see xref:../osd_support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring]

osd_architecture/osd-understanding.adoc

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

administering_a_cluster/_attributes osd_architecture/osd_policy/_attributes

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