Merge pull request #55108 from gabriel-rh/SVRCOM-2126-restructure-installing

SVRCOM-2126 Restructure the Installing section

Author: gabriel-rh

_topic_maps/_topic_map.yml

@@ -3748,23 +3748,25 @@ Topics:
     File: serverless-brokers
   - Name: Channels and subscriptions
     File: serverless-channels
-- Name: Install
+- Name: Installing Serverless
   Dir: install
   Topics:
-  - Name: Installing the OpenShift Serverless Operator
+  - Name: Preparing to install OpenShift Serverless
+    File: preparing-serverless-install
+  - Name: Installing the Serverless Operator
     File: install-serverless-operator
+  - Name: Installing the Knative CLI
+    File: installing-kn    
   - Name: Installing Knative Serving
     File: installing-knative-serving
   - Name: Installing Knative Eventing
     File: installing-knative-eventing
-  - Name: Removing OpenShift Serverless
-    File: removing-openshift-serverless
+  - Name: Configuring Serverless Functions
+    File: configuring-serverless-functions
 # Knative kn CLI
 - Name: Knative CLI
   Dir: cli_tools
   Topics:
-  - Name: Installing the Knative CLI
-    File: installing-kn
   - Name: Configuring the Knative CLI
     File: advanced-kn-config
   - Name: Knative CLI plugins
@@ -3842,9 +3844,6 @@ Topics:
 # Tracing
 - Name: Tracing
   File: serverless-tracing
-# Support
-- Name: Support
-  File: serverless-support
 # Security
 - Name: Security
   Dir: security
@@ -3889,3 +3888,20 @@ Topics:
     File: serverless-cost-management-integration
   - Name: Using NVIDIA GPU resources with serverless applications
     File: gpu-resources
+# Removing  
+- Name: Removing Serverless
+  Dir: removing
+  Topics:
+  - Name: Removing Serverless overview
+    File: removing-openshift-serverless
+  - Name: Uninstalling Knative Eventing
+    File: uninstalling-knative-eventing
+  - Name: Uninstalling Knative Serving
+    File: uninstalling-knative-serving
+  - Name: Removing Serverless Operator
+    File: removing-serverless-operator
+  - Name: Deleting Serverless CRDs
+    File: deleting-serverless-crds
+# Support
+- Name: Serverless support
+  File: serverless-support

_topic_maps/_topic_map_osd.yml

@@ -343,22 +343,24 @@ Topics:
     File: serverless-brokers
   - Name: Channels and subscriptions
     File: serverless-channels
-- Name: Install
+- Name: Installing Serverless
   Dir: install
   Topics:
-  - Name: Installing the OpenShift Serverless Operator
+  - Name: Preparing to install OpenShift Serverless
+    File: preparing-serverless-install
+  - Name: Installing the Serverless Operator
     File: install-serverless-operator
+  - Name: Installing the Knative CLI
+    File: installing-kn
   - Name: Installing Knative Serving
     File: installing-knative-serving
   - Name: Installing Knative Eventing
     File: installing-knative-eventing
-  - Name: Removing OpenShift Serverless
-    File: removing-openshift-serverless
+  - Name: Configuring Serverless Functions
+    File: configuring-serverless-functions
 - Name: Knative CLI
   Dir: cli_tools
   Topics:
-  - Name: Installing the Knative CLI
-    File: installing-kn
   - Name: Configuring the Knative CLI
     File: advanced-kn-config
   - Name: Knative Serving CLI commands
@@ -425,8 +427,6 @@ Topics:
 # Tracing
 - Name: Tracing
   File: serverless-tracing
-- Name: Support
-  File: serverless-support
 - Name: Security
   Dir: security
   Topics:
@@ -459,6 +459,23 @@ Topics:
     File: serverless-functions-annotations
   - Name: Functions development reference guide
     File: serverless-functions-reference-guide
+# Removing  
+- Name: Removing Serverless
+  Dir: removing
+  Topics:
+  - Name: Removing Serverless overview
+    File: removing-openshift-serverless
+  - Name: Uninstalling Knative Eventing
+    File: uninstalling-knative-eventing
+  - Name: Uninstalling Knative Serving
+    File: uninstalling-knative-serving
+  - Name: Removing Serverless Operator
+    File: removing-serverless-operator
+  - Name: Deleting Serverless CRDs
+    File: deleting-serverless-crds
+# Support
+- Name: Serverless support
+  File: serverless-support
 ---
 Name: Troubleshooting
 Dir: osd_support

_topic_maps/_topic_map_rosa.yml

@@ -541,22 +541,24 @@ Topics:
     File: serverless-brokers
   - Name: Channels and subscriptions
     File: serverless-channels
-- Name: Install
+- Name: Installing Serverless
   Dir: install
   Topics:
-  - Name: Installing the OpenShift Serverless Operator
+  - Name: Preparing to install OpenShift Serverless
+    File: preparing-serverless-install
+  - Name: Installing the Serverless Operator
     File: install-serverless-operator
+  - Name: Installing the Knative CLI
+    File: installing-kn    
   - Name: Installing Knative Serving
     File: installing-knative-serving
   - Name: Installing Knative Eventing
     File: installing-knative-eventing
-  - Name: Removing OpenShift Serverless
-    File: removing-openshift-serverless
+  - Name: Configuring Serverless Functions
+    File: configuring-serverless-functions
 - Name: Knative CLI
   Dir: cli_tools
   Topics:
-  - Name: Installing the Knative CLI
-    File: installing-kn
   - Name: Configuring the Knative CLI
     File: advanced-kn-config
   - Name: Knative Serving CLI commands
@@ -623,8 +625,6 @@ Topics:
 # Tracing
 - Name: Tracing
   File: serverless-tracing
-- Name: Support
-  File: serverless-support
 - Name: Security
   Dir: security
   Topics:
@@ -657,6 +657,23 @@ Topics:
     File: serverless-functions-annotations
   - Name: Functions development reference guide
     File: serverless-functions-reference-guide
+# Removing  
+- Name: Removing Serverless
+  Dir: removing
+  Topics:
+  - Name: Removing Serverless overview
+    File: removing-openshift-serverless
+  - Name: Uninstalling Knative Eventing
+    File: uninstalling-knative-eventing
+  - Name: Uninstalling Knative Serving
+    File: uninstalling-knative-serving
+  - Name: Removing Serverless Operator
+    File: removing-serverless-operator
+  - Name: Deleting Serverless CRDs
+    File: deleting-serverless-crds
+# Support
+- Name: Serverless support
+  File: serverless-support
 ---
 Name: Troubleshooting
 Dir: rosa_support

cli_reference/kn-cli-tools.adoc

@@ -25,4 +25,4 @@ Key features of the Knative CLI include:
 [id="kn-cli-tools-installing-kn"]
 == Installing the Knative CLI
 
-See xref:../serverless/cli_tools/installing-kn.adoc#installing-kn[Installing the Knative CLI].
+See xref:../serverless/install/installing-kn.adoc#installing-kn[Installing the Knative CLI].

modules/serverless-cluster-sizing-req.adoc

@@ -1,6 +1,6 @@
 // Module included in the following assemblies:
 //
-// * /serverless/install/install-serverless-operator.adoc
+// * /serverless/install/preparing-serverless-install.adoc
 
 :_content-type: REFERENCE
 [id="serverless-cluster-sizing-req_{context}"]

modules/serverless-deleting-crds.adoc

@@ -4,14 +4,9 @@
 
 :_content-type: PROCEDURE
 [id="serverless-deleting-crds_{context}"]
-= Deleting {ServerlessProductName} custom resource definitions
+= Removing {ServerlessProductName} Operator and API CRDs
 
-After uninstalling the {ServerlessProductName}, the Operator and API custom resource definitions (CRDs) remain on the cluster. You can use the following procedure to remove the remaining CRDs.
-
-[IMPORTANT]
-====
-Removing the Operator and API CRDs also removes all resources that were defined by using them, including Knative services.
-====
+Delete the Operator and API CRDs using the following procedure.
 
 .Prerequisites
 

modules/serverless-uninstalling-knative-eventing.adoc

@@ -1,13 +1,11 @@
 // Module included in the following assemblies:
 //
-// * serverless/install/removing-openshift-serverless.adoc
+// * serverless/removing/uninstalling-knative-eventing.adoc
 
 :_content-type: PROCEDURE
 [id="serverless-uninstalling-knative-eventing_{context}"]
 = Uninstalling Knative Eventing
 
-Before you can remove the {ServerlessOperatorName}, you must remove Knative Eventing. To uninstall Knative Eventing, you must remove the `KnativeEventing` custom resource (CR) and delete the `knative-eventing` namespace.
-
 .Prerequisites
 
 ifdef::openshift-enterprise[]

modules/serverless-uninstalling-knative-serving.adoc

@@ -6,8 +6,6 @@
 [id="serverless-uninstalling-knative-serving_{context}"]
 = Uninstalling Knative Serving
 
-Before you can remove the {ServerlessOperatorName}, you must remove Knative Serving. To uninstall Knative Serving, you must remove the `KnativeServing` custom resource (CR) and delete the `knative-serving` namespace.
-
 .Prerequisites
 
 ifdef::openshift-enterprise[]

serverless/discover/about-serverless.adoc

@@ -28,22 +28,6 @@ You can propagate an event from an xref:../../serverless/discover/knative-event-
 
 // add something about CLI tools?
 
-[id="about-serverless-supported-configs"]
-== Supported configurations
-
-The set of supported features, configurations, and integrations for {ServerlessProductName}, current and past versions, are available at the link:https://access.redhat.com/articles/4912821[Supported Configurations page].
-
-ifdef::openshift-enterprise[]
-[id="about-serverless-scalability-performance"]
-== Scalability and performance
-
-{ServerlessProductName} has been tested with a configuration of 3 main nodes and 3 worker nodes, each of which has 64 CPUs, 457 GB of memory, and 394 GB of storage each.
-
-The maximum number of Knative services that can be created using this configuration is 3,000. This corresponds to the xref:../../scalability_and_performance/planning-your-environment-according-to-object-maximums.adoc#cluster-maximums-major-releases_object-limits[{product-title} Kubernetes services limit of 10,000], since 1 Knative service creates 3 Kubernetes services.
-
-The average scale from zero response time was approximately 3.4 seconds, with a maximum response time of 8 seconds, and a 99.9th percentile of 4.5 seconds for a simple Quarkus application. These times might vary depending on the application and the runtime of the application.
-endif::[]
-
 [id="additional-resources_about-serverless"]
 [role="_additional-resources"]
 == Additional resources

serverless/functions/serverless-functions-setup.adoc

@@ -29,7 +29,7 @@ ifdef::openshift-dedicated,openshift-rosa[]
 * You have the `oc` CLI installed.
 endif::[]
 
-* You have the xref:../../serverless/cli_tools/installing-kn.adoc#installing-kn[Knative (`kn`) CLI] installed. Installing the Knative CLI enables the use of `kn func` commands which you can use to create and manage functions.
+* You have the xref:../../serverless/install/installing-kn.adoc#installing-kn[Knative (`kn`) CLI] installed. Installing the Knative CLI enables the use of `kn func` commands which you can use to create and manage functions.
 
 * You have installed Docker Container Engine or Podman version 3.4.7 or higher.