OSDOCS-16026 4 category restructure

Author: jmanthei

_topic_maps/_topic_map.yml

@@ -1647,14 +1647,18 @@ Topics:
   Dir: ingress_load_balancing
   Distros: openshift-enterprise,openshift-origin
   Topics:
-  - Name: Configuring Routes
+  - Name: Routes
     Dir: routes
     Distros: openshift-enterprise,openshift-origin
     Topics:
-    - Name: Route configuration
-      File: route-configuration
-    - Name: Secured routes
-      File: secured-routes
+    - Name: Creating basic routes
+      File: creating-basic-routes
+    - Name: Securing routes
+      File: securing-routes
+    - Name: Configuring routes
+      File: nw-configuring-routes
+    - Name: Creating advanced routes
+      File: creating-advanced-routes
   - Name: Configuring ingress cluster traffic
     Dir: configuring_ingress_cluster_traffic
     Distros: openshift-enterprise,openshift-origin

applications/deployments/route-based-deployment-strategies.adoc

@@ -40,5 +40,10 @@ ifndef::openshift-rosa-hcp[]
 [id="additional-resources_{context}"]
 == Additional resources
 
-* xref:../../networking/ingress_load_balancing/routes/route-configuration.adoc#nw-route-specific-annotations_route-configuration[Route-specific annotations].
-endif::[]
+ifdef::openshift-rosa,openshift-rosa-hcp,openshift-dedicated[]
+* xref:../../networking/ingress_load_balancing/routes/route-configuration.adoc#nw-route-specific-annotations_route-configuration[Route-specific annotations]
+endif::openshift-rosa,openshift-rosa-hcp,openshift-dedicated[]
+
+ifdef::openshift-enterprise[]
+* xref:../../networking/ingress_load_balancing/routes/nw-configuring-routes.adoc#nw-route-specific-annotations[Route-specific annotations]
+endif::openshift-enterprise[]

cloud_experts_tutorials/cloud-experts-getting-started/cloud-experts-getting-started-openshift-concepts.adoc

@@ -127,7 +127,7 @@ An individual route can override some defaults by providing specific configurati
 [role="_additional-resources"]
 .Additional resources
 
-* xref:../../networking/ingress_load_balancing/routes/route-configuration.adoc#nw-route-specific-annotations_route-configuration[Route-specific annotations]
+* xref:../../networking/ingress_load_balancing/routes/route-configuration.adoc#nw-route-specific-annotations_route-configuration[Route-specific-annotations]
 
 [id="cloud-experts-getting-started-openshift-concepts-imagestreams"]
 == Image streams

networking/ingress_load_balancing/routes/creating-advanced-routes.adoc

@@ -0,0 +1,24 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/common-attributes.adoc[]
+[id="creating-advanced-routes"]
+ = Creating advanced routes
+
+toc::[]
+
+You can create secure routes with the ability to use several types of TLS termination to serve certificates to the client. The following sections describe how to create re-encrypt, edge, and passthrough routes with custom certificates.
+
+
+//Creating an edge route with a custom certificate
+include::modules/nw-ingress-creating-an-edge-route-with-a-custom-certificate.adoc[leveloffset=+1]
+
+//Creating a reencrypt route with a custom certificate
+include::modules/nw-ingress-creating-a-reencrypt-route-with-a-custom-certificate.adoc[leveloffset=+1]
+
+//Creating a passthrough route
+include::modules/nw-ingress-creating-a-passthrough-route.adoc[leveloffset=+1]
+
+//Creating a route using the destination CA certificate
+include::modules/nw-ingress-reencrypt-route-custom-cert.adoc[leveloffset=+1]
+
+//Creating a route with externally managed certificates
+include::modules/nw-ingress-route-secret-load-external-cert.adoc[leveloffset=+1]

networking/ingress_load_balancing/routes/creating-basic-routes.adoc

@@ -0,0 +1,13 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/common-attributes.adoc[]
+[id="creating-basic-routes"]
+= Creating basic routes
+:context: configuring-routes
+
+toc::[]
+
+If you have unencrypted HTTP, you can create a basic route with a route object.
+
+include::modules/nw-creating-a-route.adoc[leveloffset=+1]
+
+include::modules/nw-path-based-routes.adoc[leveloffset=+1]

networking/ingress_load_balancing/routes/nw-configuring-routes.adoc

@@ -0,0 +1,27 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/common-attributes.adoc[]
+[id="nw-configuring-routes"]
+= Configuring routes
+:context: configuring-routes
+
+toc::[]
+
+You can use annotations, headers, cookies, and more to customize your route configuration.
+
+//Configuring route timeouts
+include::modules/nw-configuring-route-timeouts.adoc[leveloffset=+1]
+
+//HTTP header configuration
+include::modules/nw-http-header-configuration.adoc[leveloffset=+1]
+
+//Setting or deleting http headers
+include::modules/nw-route-set-or-delete-http-headers.adoc[leveloffset=+1]
+
+//Using cookies to keep route statefulness
+include::modules/nw-using-cookies-keep-route-statefulness.adoc[leveloffset=+1]
+
+//Annotating a route with a cookie name
+include::modules/nw-annotating-a-route-with-a-cookie-name.adoc[leveloffset=+2]
+
+//Additional annotations (to be separated into modules with more detail at a later date)
+include::modules/nw-route-specific-annotations.adoc[leveloffset=+1]

networking/ingress_load_balancing/routes/securing-routes.adoc

@@ -0,0 +1,21 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/common-attributes.adoc[]
+[id="securing-routes"]
+= Securing routes
+:context: configuring-routes
+
+[toc]
+
+You can secure a route with HTTP strict transport security (HSTS).
+
+//HTTP Strict Transport Security
+include::modules/nw-enabling-hsts.adoc[leveloffset=+1]
+
+//Enabling HTTP strict transport security per-route
+include::modules/nw-enabling-hsts-per-route.adoc[leveloffset=+2]
+
+//Disabling HTTP strict transport security per-route
+include::modules/nw-disabling-hsts.adoc[leveloffset=+2]
+
+//Enforcing HTTP strict transport security per-domain
+include::modules/nw-enforcing-hsts-per-domain.adoc[leveloffset=+2]

security/cert_manager_operator/cert-manager-securing-routes.adoc

@@ -6,14 +6,14 @@ include::_attributes/common-attributes.adoc[]
 
 toc::[]
 
-In the {product-title}, the route API is extended to provide a configurable option to reference TLS certificates via secrets. With xref:../../networking/ingress_load_balancing/routes/secured-routes.adoc#nw-ingress-route-secret-load-external-cert_secured-routes[externally managed certificates] enabled, you can minimize errors from manual intervention, streamline the certificate management process, and enable the {product-title} router to promptly serve the referenced certificate.
+In the {product-title}, the route API is extended to provide a configurable option to reference TLS certificates via secrets. With xref:../../networking/ingress_load_balancing/routes/creating-advanced-routes.adoc#nw-ingress-route-secret-load-external-cert_secured-routes[externally managed certificates] enabled, you can minimize errors from manual intervention, streamline the certificate management process, and enable the {product-title} router to promptly serve the referenced certificate.
 
 include::modules/cert-manager-configuring-routes.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
 [id="additional-resources_{context}"]
 == Additional resources
 
-* xref:../../networking/ingress_load_balancing/routes/secured-routes.adoc#nw-ingress-route-secret-load-external-cert_secured-routes[Creating a route with externally managed certificate]
+* xref:../../networking/ingress_load_balancing/routes/nw-configuring-routes.adoc#nw-ingress-route-secret-load-external-cert_secured-routes[Creating a route with externally managed certificate]
 
 * xref:../../security/cert_manager_operator/cert-manager-operator-issuer-acme.adoc#cert-manager-operator-issuer-acme[Configuring an ACME issuer]

security/certificates/service-serving-certificate.adoc

@@ -12,7 +12,7 @@ include::modules/customize-certificates-add-service-serving.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
 .Additional resources
-* You can use a service certificate to configure a secure route using reencrypt TLS termination. For more information, see xref:../../networking/ingress_load_balancing/routes/secured-routes.adoc#nw-ingress-creating-a-reencrypt-route-with-a-custom-certificate_secured-routes[Creating a re-encrypt route with a custom certificate].
+* You can use a service certificate to configure a secure route using reencrypt TLS termination. For more information, see xref:../../networking/ingress_load_balancing/routes/creating-advanced-routes.adoc#nw-ingress-creating-a-reencrypt-route-with-a-custom-certificate_secured-routes[Creating a re-encrypt route with a custom certificate].
 
 include::modules/customize-certificates-add-service-serving-configmap.adoc[leveloffset=+1]
 

service_mesh/v2x/ossm-route-migration.adoc

@@ -14,5 +14,5 @@ include::modules/ossm-migrating-from-ior-to-explicitly-managed-routes.adoc[level
 [id="additional-resources_{context}"]
 == Additional resources
 
-* xref:../../networking/ingress_load_balancing/routes/route-configuration.adoc#nw-creating-a-route_route-configuration[Creating an HTTP-based Route]
+* xref:../../networking/ingress_load_balancing/routes/creating-basic-routes.adoc#nw-creating-a-route_route-configuration[Creating an HTTP-based Route]
 * xref:../../service_mesh/v2x/ossm-traffic-manage.adoc#ossm-auto-route_traffic-management[Understanding automatic routes]