docs: Create Documentation for Cordon Pools and modify other Docs

Signed-off-by: Bala Harish <bala.harish.ac@datacore.com>

Author: balaharish7

docs/main/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/advanced-operations/node-cordon.md renamed to docs/main/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/advanced-operations/cordon-node.md

@@ -1,15 +1,22 @@
 ---
-id: node-cordon
-title: Node Cordon
+id: cordon-node
+title: Cordon a Node
 keywords:
  - Node Cordon
+ - Cordon Node
 description: This guide explains about the Node Cordon feature.
 ---
 
+# Cordon a Node
+
+## Overview
+
 Cordoning a node marks or taints the node as unschedulable. This prevents the scheduler from deploying new resources on that node. However, the resources that were deployed prior to cordoning off the node will remain intact.
 
 This feature is in line with the node-cordon functionality of Kubernetes.
 
+## Cordon a Node
+
 To add a label and cordon a node, execute:
 **Command**
 ```
@@ -29,13 +36,12 @@ To view the labels associated with a cordoned node, execute:
 kubectl-mayastor get cordon node <node_name>
 ```
 
-### How to uncordon a node?
+## Uncordon a Node
 
 To make a node schedulable again, execute:
 **Command**
 ```
 kubectl-mayastor uncordon node <node_name> <label>
 ```
 
-The above command allows the Kubernetes scheduler to deploy resources on the node.
-
+The above command allows the Kubernetes scheduler to deploy resources on the node.

docs/main/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/advanced-operations/cordon-pools.md

@@ -0,0 +1,74 @@
+---
+id: cordon-pools
+title: Cordon Pools
+keywords:
+ - Cordon Replicated PV Mayastor Pools
+ - Cordon and Uncordon Pools
+ - Cordon Pools
+description: This guide explains how to cordon and uncordon pools.
+---
+
+# Cordon Pools
+
+## Overview
+
+Pool Cordon allows you to temporarily prevent new replicas, snapshots, restores, or imports from being scheduled on a specific Replicated PV Mayastor pool.
+Use cordon during planned maintenance, hardware investigations, or controlled decommissioning. Existing data remains fully available and unaffected until explicitly migrated or removed.
+
+## Requirements
+
+You can configure the maximum pool size using the `maxExpansion` field in the DiskPool CR.
+
+- Replicated PV Mayastor deployment with a version that supports pool cordoning
+
+- `kubectl-mayastor` or `kubectl-openebs` plugin installed and configured with appropriate administrative access
+
+## Cordon a Pool
+
+When you cordon a pool, specify the resource types you want to block by including their flags. A flag’s presence sets that resource type to true (cordoned). If you omit a flag, that resource type remains uncordoned (false).
+
+Cordon a pool to block new replicas and imports using `kubectl-openebs`. For Example: `kubectl-openebs mayastor`
+
+**Cordon a Pool to Block New Replicas and Imports**
+
+```
+kubectl-openebs mayastor cordon pool <pool-name> --replicas
+```
+
+```
+kubectl-openebs mayastor cordon pool <pool-name> --replicas --imports
+```
+
+**Flags**
+
+- `--replicas` - Prevent new replicas from being created on the pool
+- `--snapshots` - Prevent new snapshots from being scheduled
+- `--restores` - Prevent new restore operations on the pool
+- `--imports` - Prevent pool import operations.
+
+## Uncordon a Pool
+
+When you uncordon a pool, you remove the scheduling restrictions and allow new resources to be created again. Use this when maintenance is complete or when you want the pool to resume normal operations.
+
+**Uncordon a Pool and Re-enable All Resource Scheduling**
+
+```
+kubectl-openebs mayastor uncordon pool <pool-name> --replicas --imports
+```
+
+**Flags**
+
+- The same flags apply as with cordon, letting you selectively enable scheduling for replicas, snapshots, restores, and imports.
+- By default, running uncordon pool without flags will remove all existing cordons, restoring full scheduling for the pool.
+
+## Typical Use Cases
+
+- Planned Maintenance: Isolate a pool before firmware upgrades or hardware replacement.
+- Capacity Management: Prevent new replicas on a pool nearing its operational threshold.
+- Controlled Decommissioning: Cordon, migrate replicas, and then retire the pool.
+
+:::note
+- Cordoning blocks new resources only. It does not move or delete existing data.
+- Make sure enough other pools remain uncordoned to keep volumes healthy.
+- Pools stay cordoned across restarts until you explicitly uncordon them.
+:::

docs/main/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/advanced-operations/node-drain.md renamed to docs/main/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/advanced-operations/drain-node.md

@@ -1,14 +1,21 @@
 ---
-id: node-drain
-title: Node Drain
+id: drain-node
+title: Drain a Node
 keywords:
  - Node Drain
+ - Drain a Node
 description: This guide explains about the Node Drain feature.
 ---
 
-The node drain functionality marks the node as unschedulable and then gracefully moves all the volume targets off the drained node. 
+# Drain a Node
+
+## Overview
+
+The node drain functionality marks the node as unschedulable and then gracefully moves all the volume targets off the drained node.
+
 This feature is in line with the [node drain functionality of Kubernetes](https://kubernetes.io/docs/tasks/administer-cluster/safely-drain-node/).
 
+## Drain a Node
 
 To start the drain operation, execute:
 
@@ -26,6 +33,8 @@ To get the list of nodes on which the drain operation has been performed, execut
 kubectl-mayastor get drain nodes
 ```
 
+## Halt Drain
+
 To halt the drain operation or to make the node schedulable again, execute:
 
 **Command**

docs/main/user-guides/replicated-storage-user-guide/replicated-pv-mayastor/advanced-operations/kubectl-plugin.md

@@ -9,15 +9,15 @@ keywords:
  - Replicated PV Mayastor kubectl plugin
 description: This guide will help you to view and manage Replicated PV Mayastor resources such as nodes, pools, and volumes.
 ---
-# Kubectl Plugin
+# Kubectl Mayastor Plugin
 
 The **Mayastor kubectl plugin** can be used to view and manage Replicated PV Mayastor resources such as nodes, pools and volumes. It is also used for operations such as scaling the replica count of volumes. 
 
-## Install kubectl plugin
+## Install `kubectl Mayastor plugin`
 
-- The Mayastor kubectl plugin is available for the Linux platform. The binary for the plugin can be found [here](https://github.com/mayadata-io/mayastor-control-plane/releases). 
+- The Mayastor kubectl plugin is available for the Linux platform. You can download the binary for the plugin from the [releases page](https://github.com/mayadata-io/mayastor-control-plane/releases). 
 
-- Add the downloaded Mayastor kubectl plugin under $PATH.
+- After downloading, add the downloaded Mayastor kubectl plugin under $PATH.
 
 To verify the installation, execute:
 

docs/sidebars.js

@@ -461,7 +461,7 @@ module.exports = {
                     {
                       type: "doc",
                       id: "user-guides/replicated-storage-user-guide/replicated-pv-mayastor/advanced-operations/kubectl-plugin",
-                      label: "Kubectl Plugin"
+                      label: "Kubectl Mayastor Plugin"
                     },
                     {
                       type: "doc",
@@ -498,15 +498,21 @@ module.exports = {
                       id: "user-guides/replicated-storage-user-guide/replicated-pv-mayastor/advanced-operations/monitoring",
                       label: "Monitoring"
                     },
+
+                    {
+                      type: "doc",
+                      id: "user-guides/replicated-storage-user-guide/replicated-pv-mayastor/advanced-operations/cordon-node",
+                      label: "Cordon Node"
+                    },
                     {
                       type: "doc",
-                      id: "user-guides/replicated-storage-user-guide/replicated-pv-mayastor/advanced-operations/node-cordon",
-                      label: "Node Cordon"
+                      id: "user-guides/replicated-storage-user-guide/replicated-pv-mayastor/advanced-operations/drain-node",
+                      label: "Drain Node"
                     },
                     {
                       type: "doc",
-                      id: "user-guides/replicated-storage-user-guide/replicated-pv-mayastor/advanced-operations/node-drain",
-                      label: "Node Drain"
+                      id: "user-guides/replicated-storage-user-guide/replicated-pv-mayastor/advanced-operations/cordon-pools",
+                      label: "Cordon Pools"
                     },
                     {
                       type: "doc",