docs(refactor): updates the cruise control rebalance concepts (strimz…

…i#10810)

Signed-off-by: prmellor <pmellor@redhat.com>

documentation/assemblies/cruise-control/assembly-cruise-control-concepts.adoc

@@ -5,17 +5,25 @@
 [id='cruise-control-concepts-{context}']
 = Using Cruise Control for cluster rebalancing
 
-include::../../modules/cruise-control/con-cruise-control-description.adoc[leveloffset=+1]
+[role="_abstract"]
+Cruise Control is an open-source application designed to run alongside Kafka to help optimize use of cluster resources by doing the following:
 
-NOTE: Strimzi provides xref:config-examples-{context}[example configuration files for Cruise Control].
+* Monitoring cluster workload
+* Rebalancing partitions based on predefined constraints
 
-include::../../modules/cruise-control/con-cruise-control-overview.adoc[leveloffset=+1]
+Cruise Control operations help with running a more balanced Kafka cluster that uses brokers more efficiently.
 
-include::../../modules/cruise-control/con-optimization-goals.adoc[leveloffset=+1]
+As Kafka clusters evolve, some brokers may become overloaded while others remain underutilized. 
+Cruise Control addresses this imbalance by modeling resource utilization at the replica level--including, CPU, disk, network load--and generating optimization proposals (which you can approve or reject) for balanced partition assignments based on configurable optimization goals.
 
-include::../../modules/cruise-control/con-optimization-proposals.adoc[leveloffset=+1]
+Optimization proposals are configured and generated using a `KafkaRebalance` resource. 
+You can configure the resource using an annotation so that optimization proposals are approved automatically or manually.
 
-include::../../modules/cruise-control/con-rebalance-performance.adoc[leveloffset=+1]
+NOTE: Strimzi provides xref:config-examples-{context}[example configuration files for Cruise Control].
+
+//overview and concepts
+include::../../modules/cruise-control/con-cruise-control-overview.adoc[leveloffset=+1]
+include::../../modules/cruise-control/con-rebalance-performance.adoc[leveloffset=+2]
 
 include::../../modules/cruise-control/proc-configuring-deploying-cruise-control.adoc[leveloffset=+1]
 

documentation/modules/configuring/con-config-examples.adoc

@@ -48,6 +48,6 @@ examples
 <7> `Kafka` and `KafkaNodePool` configurations for a deployment of Kafka clusters that use KRaft (Kafka Raft metadata) mode.
 <8> `Kafka` and `KafkaRebalance` configurations for deploying and using Cruise Control to manage clusters. 
 `Kafka` configuration examples enable auto-rebalancing on scaling events and set default optimization goals.
-`KakaRebalance` configuration examples set user-provided optimization goals and generate optimization proposals in various supported modes.
+`KakaRebalance` configuration examples set proposal-specific optimization goals and generate optimization proposals in various supported modes.
 <9> `KafkaConnect` and `KafkaConnector` custom resource configuration for a deployment of Kafka Connect. Includes example configurations for a single or multi-node deployment.
 <10> `KafkaBridge` custom resource configuration for a deployment of Kafka Bridge.