Add subsection descriptions in Configuration & Operation chapter

pedroielpi3 · pedroielpi3 · commit 6aaf404fc11f · 2025-03-17T18:10:46.000+01:00
Signed-off-by: Pedro Ielpi &lt;pielpi@opennebula.io&gt;
diff --git a/content/docs/configuration_and_operation/cloud_system_administration/authentication_configuration/_index.md b/content/docs/configuration_and_operation/cloud_system_administration/authentication_configuration/_index.md
@@ -1,7 +1,7 @@
 ---
 title: "Authentication Configuration"
 date: "2025-02-17"
-description:
+description: "Set up authentication for OpenNebula and for Sunstone on several backends"
 categories:
 pageintoc: "121"
 tags:
diff --git a/content/docs/configuration_and_operation/cloud_system_administration/capacity_planning/_index.md b/content/docs/configuration_and_operation/cloud_system_administration/capacity_planning/_index.md
@@ -1,26 +1,11 @@
 ---
 title: "Capacity Planning"
 date: "2025-02-17"
-description:
+description: "Define resource usage and quotas by VMs, VM groups, and cloud users"
 categories:
 pageintoc: "133"
 tags:
 weight: "4"
 ---
 
 <!--# Capacity Planning -->
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/content/docs/configuration_and_operation/cloud_system_administration/capacity_planning/overview.md b/content/docs/configuration_and_operation/cloud_system_administration/capacity_planning/overview.md
@@ -17,11 +17,9 @@ weight: "1"
 This Chapter shows different mechanism available to administrators to control the capacity assigned to Virtual Machines as well as that available to the users:
 
 > - First you can control the apparent capacity of [Hosts configuring its overcommitment]({{% relref "overcommitment#overcommitment" %}}).
-> - Also you can fine tune [the scheduling policies]({{% relref "../scheduling/scheduling#scheduling" %}}) that controls how resources from Hosts, Datastores, and Virtual Networks are allocated to Virtual Machines.
 > - Similarly, you can limit the resources that are made available to [users with the quota system]({{% relref "quotas#quota-auth" %}}).
-> - Finally, some workloads may require that you co-allocate or coordinate the capacity assigned to a group of Virtual Machines. [Affinity and placement rules can be set for VM groups]({{% relref "../scheduling/affinity#vmgroups" %}}).
 
-This chapter also includes a description on how to extend the scheduling component by configuring external modules, [see the external scheduler API section for more details]({{% relref "../scheduling/external#external-scheduler" %}}).
+It is also recommended to refer to the [Scheduling]({{% relref "../scheduling" %}}) section for details on controlling allocation of resources from Hosts, Datastores and Virtual Networks to Virtual Machines, and [defining VM groups]({{% relref "../scheduling/affinity#vmgroups" %}}) for setting up affinity and resource placement rules.
 
 ## Hypervisor Compatibility
 
diff --git a/content/docs/configuration_and_operation/cloud_system_administration/monitoring_and_alerting/_index.md b/content/docs/configuration_and_operation/cloud_system_administration/monitoring_and_alerting/_index.md
@@ -1,7 +1,7 @@
 ---
 title: "Monitoring and Alerting"
 date: "2025-02-17"
-description:
+description: "Configure monitoring and alerts with Prometheus and Grafana"
 categories:
 pageintoc: "127"
 tags:
diff --git a/content/docs/configuration_and_operation/cloud_system_administration/multitenancy/_index.md b/content/docs/configuration_and_operation/cloud_system_administration/multitenancy/_index.md
@@ -1,7 +1,7 @@
 ---
 title: "Multitenancy"
 date: "2025-02-17"
-description:
+description: "Manage permissions, ACLs and resources for users and groups"
 categories:
 pageintoc: "112"
 tags:
@@ -11,58 +11,3 @@ weight: "1"
 <a id="multitenancy"></a>
 
 <!--# Users and Groups -->
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/content/docs/configuration_and_operation/cloud_system_administration/scheduling/_index.md b/content/docs/configuration_and_operation/cloud_system_administration/scheduling/_index.md
@@ -1,30 +1,11 @@
 ---
 title: "Scheduling"
 date: "2025-02-17"
-description:
+description: "Define and configure Virtual Machine scheduling policies"
 categories:
 pageintoc: "137"
 tags:
 weight: "5"
 ---
 
 <!--# Capacity Planning -->
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/content/docs/configuration_and_operation/cloud_system_administration/scheduling/overview.md b/content/docs/configuration_and_operation/cloud_system_administration/scheduling/overview.md
@@ -14,14 +14,13 @@ weight: "1"
 
 ## How Should I Read This Chapter
 
-This Chapter shows different mechanism available to administrators to control the capacity assigned to Virtual Machines as well as that available to the users:
+Scheduling policies control how resources from Hots Datastores and Networks are allocated to Virtual Machines.
 
-> - First you can control the apparent capacity of [Hosts configuring its overcommitment]({{% relref "../capacity_planning/overcommitment#overcommitment" %}}).
-> - Also you can fine tune [the scheduling policies]({{% relref "scheduling#scheduling" %}}) that controls how resources from Hosts, Datastores, and Virtual Networks are allocated to Virtual Machines.
-> - Similarly, you can limit the resources that are made available to [users with the quota system]({{% relref "../capacity_planning/quotas#quota-auth" %}}).
-> - Finally, some workloads may require that you co-allocate or coordinate the capacity assigned to a group of Virtual Machines. [Affinity and placement rules can be set for VM groups]({{% relref "affinity#vmgroups" %}}).
+This section describes:
 
-This chapter also includes a description on how to extend the scheduling component by configuring external modules, [see the external scheduler API section for more details]({{% relref "external#external-scheduler" %}}).
+> - How to configure and fine-tune scheduling policies for [assigning priorities to the use of resources]({{% relref "scheduling" %}})
+> - How to co-allocate or coordinate capacity assigned to [related Virtual Machines]({{% relref "affinity" %}})
+> - How to extend the scheduler by [configuring external modules]({{% relref "external#external-scheduler" %}}).
 
 ## Hypervisor Compatibility
 
diff --git a/content/docs/configuration_and_operation/cloud_system_administration/whmcs_installation_and_usage/_index.md b/content/docs/configuration_and_operation/cloud_system_administration/whmcs_installation_and_usage/_index.md
@@ -1,7 +1,7 @@
 ---
 title: "WHMCS Installation and Usage"
 date: "2025-02-17"
-description:
+description: "Set up and configure the WHMCS web host billing automation platform"
 categories:
 pageintoc: "142"
 tags:
@@ -13,21 +13,3 @@ weight: "6"
 <a id="whmcs-tenants-index"></a>
 
 <!--# WHMCS Tenants Module (EE) -->
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
diff --git a/content/docs/configuration_and_operation/virtual_machines_operation/virtual_machine_images/_index.md b/content/docs/configuration_and_operation/virtual_machines_operation/virtual_machine_images/_index.md
@@ -1,7 +1,7 @@
 ---
 title: "Virtual Machine Images"
 date: "2025-02-17"
-description: "Understand, create and manage virtual machine images"
+description: "Understand, create and manage Virtual Machine images"
 categories:
 pageintoc: "81"
 tags:
