Merge pull request #58116 from gabriel-rh/SRVCOM-2358-remove-nav-sections

SRVCOM-2358 tidy up nav sections

Author: gabriel-rh

_topic_maps/_topic_map.yml

@@ -3815,9 +3815,11 @@ Topics:
     File: installing-knative-serving
   - Name: Installing Knative Eventing
     File: installing-knative-eventing
+  - Name: Configuring Knative Kafka
+    File: serverless-kafka-admin
   - Name: Configuring Serverless Functions
     File: configuring-serverless-functions
-- Name: Knative Serving
+- Name: Serving
   Dir: knative-serving
   Topics:
   - Name: Getting started with Knative Serving
@@ -3842,7 +3844,7 @@ Topics:
     Dir: config-applications
     Topics:
     - Name: Overriding system deployment configurations
-      File: overriding-config
+      File: overriding-config-serving
     - Name: EmptyDir volumes
       File: empty-dir
     - Name: Persistent Volume Claims
@@ -3851,6 +3853,8 @@ Topics:
       File: init-containers
     - Name: Resolving image tags to digests
       File: resolving-image-tags-to-digests
+    - Name: Configuring TLS authentication
+      File: serverless-config-tls      
     - Name: Restrictive network policies
       File: restrictive-network-policies
   - Name: Traffic splitting
@@ -3965,10 +3969,6 @@ Topics:
       File: serverless-global-config-broker-class-default
     - Name: Kafka broker
       File: kafka-broker
-    - Name: Creating a Kafka broker
-      File: creating-kafka-broker
-    - Name: Security configuration for Knative Kafka
-      File: serverless-kafka-admin-security
     - Name: Managing brokers
       File: serverless-using-brokers-managing-brokers
     - Name: Event delivery
@@ -3978,12 +3978,8 @@ Topics:
     Topics:
     - Name: Triggers overview
       File: serverless-triggers
-    - Name: Creating triggers from the web console
-      File: create-trigger-odc
-    - Name: Creating triggers from the command line
-      File: create-trigger-cli
-    - Name: Creating a trigger from the Administrator perspective
-      File: create-trigger-admin
+    - Name: Creating triggers
+      File: create-triggers
     - Name: List triggers from the command line
       File: list-triggers-cli
     - Name: Describe triggers from the command line
@@ -4010,8 +4006,10 @@ Topics:
   - Name: Subscriptions
     Dir: subscriptions
     Topics:
-    - Name: Creating and managing subscriptions
+    - Name: Creating subscriptions
       File: serverless-subs
+    - Name: Managing subscriptions
+      File: serverless-subs-managing
   - Name: Event discovery
     Dir: discovery
     Topics:
@@ -4027,14 +4025,9 @@ Topics:
     Dir: tuning
     Topics:
     - Name: Overriding deployment configurations
-      File: override-config
+      File: overriding-config-eventing
     - Name: High availability
       File: serverless-ha
-  - Name: kn-event plugin
-    Dir: kn-event-plugin
-    Topics:
-    - Name: Knative CLI plugins
-      File: kn-plugins-events
 # Functions
 - Name: Functions
   Dir: functions
@@ -4092,23 +4085,6 @@ Topics:
       Topics:
         - Name: kn functions commands
           File: kn-functions
-# Admin guide
-- Name: Administer
-  Dir: admin_guide
-  Topics:
-  - Name: Global configuration
-    File: serverless-configuration
-    # Eventing
-  - Name: Configuring Knative Kafka
-    File: serverless-kafka-admin
-  - Name: Serverless components in the Administrator perspective
-    File: serverless-admin-perspective
-# Security
-- Name: Security
-  Dir: security
-  Topics:
-  - Name: Configuring TLS authentication
-    File: serverless-config-tls
 - Name: Observability
   Dir: observability
   Topics:

_topic_maps/_topic_map_osd.yml

@@ -397,9 +397,11 @@ Topics:
     File: installing-knative-serving
   - Name: Installing Knative Eventing
     File: installing-knative-eventing
+  - Name: Configuring Knative Kafka
+    File: serverless-kafka-admin
   - Name: Configuring Serverless Functions
     File: configuring-serverless-functions
-- Name: Knative Serving
+- Name: Serving
   Dir: knative-serving
   Topics:
   - Name: Getting started with Knative Serving
@@ -424,7 +426,7 @@ Topics:
     Dir: config-applications
     Topics:
     - Name: Overriding system deployment configurations
-      File: overriding-config
+      File: overriding-config-serving
     - Name: EmptyDir volumes
       File: empty-dir
     - Name: Persistent Volume Claims
@@ -433,6 +435,8 @@ Topics:
       File: init-containers
     - Name: Resolving image tags to digests
       File: resolving-image-tags-to-digests
+    - Name: Configuring TLS authentication
+      File: serverless-config-tls      
     - Name: Restrictive network policies
       File: restrictive-network-policies
   - Name: Traffic splitting
@@ -547,10 +551,6 @@ Topics:
       File: serverless-global-config-broker-class-default
     - Name: Kafka broker
       File: kafka-broker
-    - Name: Creating a Kafka broker
-      File: creating-kafka-broker
-    - Name: Security configuration for Knative Kafka
-      File: serverless-kafka-admin-security
     - Name: Managing brokers
       File: serverless-using-brokers-managing-brokers
     - Name: Event delivery
@@ -560,12 +560,8 @@ Topics:
     Topics:
     - Name: Triggers overview
       File: serverless-triggers
-    - Name: Creating triggers from the web console
-      File: create-trigger-odc
-    - Name: Creating triggers from the command line
-      File: create-trigger-cli
-    - Name: Creating a trigger from the Administrator perspective
-      File: create-trigger-admin
+    - Name: Creating triggers
+      File: create-triggers
     - Name: List triggers from the command line
       File: list-triggers-cli
     - Name: Describe triggers from the command line
@@ -592,8 +588,10 @@ Topics:
   - Name: Subscriptions
     Dir: subscriptions
     Topics:
-    - Name: Creating and managing subscriptions
+    - Name: Creating subscriptions
       File: serverless-subs
+    - Name: Managing subscriptions
+      File: serverless-subs-managing
   - Name: Event discovery
     Dir: discovery
     Topics:
@@ -609,14 +607,9 @@ Topics:
     Dir: tuning
     Topics:
     - Name: Overriding deployment configurations
-      File: override-config    
+      File: overriding-config-eventing    
     - Name: High availability
       File: serverless-ha
-  - Name: kn-event plugin
-    Dir: kn-event-plugin
-    Topics:
-    - Name: Knative CLI plugins
-      File: kn-plugins-events
 - Name: Functions
   Dir: functions
   Topics:
@@ -671,20 +664,6 @@ Topics:
       Topics:
         - Name: kn functions commands
           File: kn-functions
-- Name: Administer
-  Dir: admin_guide
-  Topics:
-  - Name: Global configuration
-    File: serverless-configuration
-  - Name: Configuring Knative Kafka
-    File: serverless-kafka-admin
-  - Name: Serverless components in the Administrator perspective
-    File: serverless-admin-perspective
-- Name: Security
-  Dir: security
-  Topics:
-  - Name: Configuring TLS authentication
-    File: serverless-config-tls
 - Name: Observability
   Dir: observability
   Topics:

_topic_maps/_topic_map_rosa.yml

@@ -592,9 +592,11 @@ Topics:
     File: installing-knative-serving
   - Name: Installing Knative Eventing
     File: installing-knative-eventing
+  - Name: Configuring Knative Kafka
+    File: serverless-kafka-admin
   - Name: Configuring Serverless Functions
     File: configuring-serverless-functions
-- Name: Knative Serving
+- Name: Serving
   Dir: knative-serving
   Topics:
   - Name: Getting started with Knative Serving
@@ -619,7 +621,7 @@ Topics:
     Dir: config-applications
     Topics:
     - Name: Overriding system deployment configurations
-      File: overriding-config
+      File: overriding-config-serving
     - Name: EmptyDir volumes
       File: empty-dir
     - Name: Persistent Volume Claims
@@ -628,6 +630,8 @@ Topics:
       File: init-containers
     - Name: Resolving image tags to digests
       File: resolving-image-tags-to-digests
+    - Name: Configuring TLS authentication
+      File: serverless-config-tls          
     - Name: Restrictive network policies
       File: restrictive-network-policies
   - Name: Traffic splitting
@@ -742,10 +746,6 @@ Topics:
       File: serverless-global-config-broker-class-default
     - Name: Kafka broker
       File: kafka-broker
-    - Name: Creating a Kafka broker
-      File: creating-kafka-broker
-    - Name: Security configuration for Knative Kafka
-      File: serverless-kafka-admin-security
     - Name: Managing brokers
       File: serverless-using-brokers-managing-brokers
     - Name: Event delivery
@@ -755,12 +755,8 @@ Topics:
     Topics:
     - Name: Triggers overview
       File: serverless-triggers
-    - Name: Creating triggers from the web console
-      File: create-trigger-odc
-    - Name: Creating triggers from the command line
-      File: create-trigger-cli
-    - Name: Creating a trigger from the Administrator perspective
-      File: create-trigger-admin
+    - Name: Creating triggers
+      File: create-triggers
     - Name: List triggers from the command line
       File: list-triggers-cli
     - Name: Describe triggers from the command line
@@ -787,8 +783,10 @@ Topics:
   - Name: Subscriptions
     Dir: subscriptions
     Topics:
-    - Name: Creating and managing subscriptions
+    - Name: Creating subscriptions
       File: serverless-subs
+    - Name: Managing subscriptions
+      File: serverless-subs-managing
   - Name: Event discovery
     Dir: discovery
     Topics:
@@ -804,14 +802,9 @@ Topics:
     Dir: tuning
     Topics:
     - Name: Overriding deployment configurations
-      File: override-config    
+      File: overriding-config-eventing    
     - Name: High availability
       File: serverless-ha
-  - Name: kn-event plugin
-    Dir: kn-event-plugin
-    Topics:
-    - Name: Knative CLI plugins
-      File: kn-plugins-events
 - Name: Functions
   Dir: functions
   Topics:
@@ -866,20 +859,6 @@ Topics:
       Topics:
         - Name: kn functions commands
           File: kn-functions
-- Name: Administer
-  Dir: admin_guide
-  Topics:
-  - Name: Global configuration
-    File: serverless-configuration
-  - Name: Configuring Knative Kafka
-    File: serverless-kafka-admin
-  - Name: Serverless components in the Administrator perspective
-    File: serverless-admin-perspective
-- Name: Security
-  Dir: security
-  Topics:
-  - Name: Configuring TLS authentication
-    File: serverless-config-tls
 - Name: Observability
   Dir: observability
   Topics:

modules/knative-eventing-CR-system-deployments.adoc

@@ -1,11 +1,18 @@
 // Module included in the following assemblies:
 //
-// * serverless/eventing/tuning/override-config.adoc
+// * serverless/eventing/tuning/overriding-config-eventing.adoc
 
 :_content-type: REFERENCE
 [id="knative-eventing-CR-system-deployments_{context}"]
 = Overriding deployment configurations
 
+Currently, overriding default configuration settings is supported for the `eventing-controller`, `eventing-webhook`, and `imc-controller` fields, as well as for the `readiness` and `liveness` fields for probes.
+
+[IMPORTANT]
+====
+The `replicas` spec cannot override the number of replicas for deployments that use the Horizontal Pod Autoscaler (HPA), and does not work for the `eventing-webhook` deployment.
+====
+
 In the following example, a `KnativeEventing` CR overrides the `eventing-controller` deployment so that:
 
 * The `readiness` probe timeout `eventing-controller` is set to be 10 seconds.

modules/knative-serving-CR-system-deployments.adoc

@@ -4,9 +4,9 @@
 
 :_content-type: REFERENCE
 [id="knative-serving-CR-system-deployments_{context}"]
-= Overriding Knative Serving system deployment configurations
+= Overriding system deployment configurations
 
-You can override the default configurations for some specific deployments by modifying the `deployments` spec in the `KnativeServing` custom resource (CR). Currently, overriding default configuration settings is supported for the `resources`, `replicas`, `labels`, `annotations`, and `nodeSelector` fields, as well as for the `readiness` and `liveness` fields for probes.
+Currently, overriding default configuration settings is supported for the `resources`, `replicas`, `labels`, `annotations`, and `nodeSelector` fields, as well as for the `readiness` and `liveness` fields for probes.
 
 In the following example, a `KnativeServing` CR overrides the `webhook` deployment so that:
 

modules/serverless-channel-default.adoc

@@ -1,6 +1,6 @@
 // Module included in the following assemblies:
 //
-//  * serverless/admin_guide/serverless-configuration.adoc
+//  * serverless/eventing/channels/serverless-channel-default.adoc
 
 :_content-type: PROCEDURE
 [id="serverless-channel-default_{context}"]

modules/serverless-create-channel-odc.adoc

@@ -4,7 +4,7 @@
 
 :_content-type: PROCEDURE
 [id="serverless-create-channel-odc_{context}"]
-= Creating a channel by using the web console
+= Creating a channel by using the Developer perspective
 
 Using the {product-title} web console provides a streamlined and intuitive user interface to create a channel. After Knative Eventing is installed on your cluster, you can create a channel by using the web console.
 

modules/serverless-create-trigger-odc.adoc

@@ -4,7 +4,9 @@
 
 :_content-type: PROCEDURE
 [id="serverless-create-trigger-odc_{context}"]
-= Creating a trigger by using the web console
+= Creating a trigger by using the Developer perspective
+
+Using the {product-title} web console provides a streamlined and intuitive user interface to create a trigger. After Knative Eventing is installed on your cluster and you have created a broker, you can create a trigger by using the web console.
 
 .Prerequisites
 

modules/serverless-creating-channel-admin-web-console.adoc

@@ -6,7 +6,7 @@
 [id="serverless-creating-channel-admin-web-console_{context}"]
 = Creating a channel by using the Administrator perspective
 
-include::snippets/serverless-channels-intro.adoc[]
+After Knative Eventing is installed on your cluster, you can create a channel by using the Administrator perspective.
 
 .Prerequisites
 

modules/serverless-creating-subscriptions-odc.adoc

@@ -4,7 +4,7 @@
 
 :_content-type: PROCEDURE
 [id="serverless-creating-subscriptions-odc_{context}"]
-= Creating a subscription by using the web console
+= Creating a subscription by using the Developer perspective
 
 After you have created a channel and an event sink, you can create a subscription to enable event delivery. Using the {product-title} web console provides a streamlined and intuitive user interface to create a subscription.