DOC-241 doc all possible cluster states (#323)

* DOC-241 doc all possible cluster states

* incorporate review feedback

* edits

* typo

* combine BYOC/Dedicated tab

* remove the Unspecified state

* reorder rows

* Update modules/manage/pages/cluster-maintenance/cluster-state.adoc

Co-authored-by: Santiago Jimenez Giraldo <[email protected]>

* incorporate Santi's feedback

* minor edit, putting suspended last

* Add cc to turn Suspended back to Ready state

* Santi's feedback for failed state

* Update modules/manage/pages/cluster-maintenance/cluster-state.adoc

Co-authored-by: Paulo Borges <[email protected]>

* Update modules/manage/pages/cluster-maintenance/cluster-state.adoc

Co-authored-by: Paulo Borges <[email protected]>

* put all cluster states in bold font

* minor edits

---------

Co-authored-by: Santiago Jimenez Giraldo <[email protected]>
Co-authored-by: Paulo Borges <[email protected]>

Author: 3 people

modules/ROOT/nav.adoc

@@ -399,6 +399,7 @@
 
 * xref:manage:index.adoc[Manage]
 ** xref:manage:cluster-maintenance/index.adoc[Cluster Maintenance]
+*** xref:manage:cluster-maintenance/cluster-state.adoc[]
 *** xref:manage:maintenance.adoc[]
 *** xref:manage:cluster-maintenance/config-cluster.adoc[]
 *** xref:manage:audit-logging.adoc[]

modules/manage/pages/cluster-maintenance/cluster-state.adoc

@@ -0,0 +1,41 @@
+= Cluster State
+:description: Learn about the current status of a cluster.
+
+The cluster state shows the current status of a cluster. Redpanda Cloud updates the state automatically, allowing you to monitor a cluster's health and availability.
+
+[tabs]
+=====
+Serverless::
++
+--
+[cols="1,4",options="header"]
+|===
+|State |Description
+|*Creating* |Cluster is in the process of having its control plane state created.
+|*Placing* |Cluster is in the process of being placed on a cell with sufficient resources in the data plane.
+|*Ready* |Cluster is running and accepting external requests.
+|*Deleting* |Cluster is in the process of having its control plane state removed. Resources dedicated to the cluster in the data plane are released.
+|*Failed* |Cluster is unable to enter the *Ready* state from either the *Creating* or *Placing* states. +
+Try re-creating the cluster.
+|*Suspended* |Cluster is running but blocks all external requests. +
+This can happen when credits run out. Enter a credit card to return to the *Ready* state.
+|===
+--
+BYOC/Dedicated::
++
+--
+[cols="1,4",options="header"]
+|===
+|State |Description
+|*Creating agent* |Cluster is in the process of having its control plane state created, and the Redpanda Cloud agent is being deployed.  
+|*Creating* |Cluster is in the process of having its control plane state created.
+|*Ready* |Cluster is running and accepting external requests.
+|*Deleting* |Cluster is in the process of having its control plane state removed. Resources dedicated to the cluster in the data plane are released.
+|*Deleting agent* |Cluster is in the process of having its control plane state and Redpanda Cloud agent removed. 
+|*Upgrading* |Cluster is undergoing a rolling upgrade or a scaling operation.
+|*Failed* |Cluster is unable to enter the *Ready* state from either the *Creating* or the *Creating agent* states. +
+Try re-creating the cluster.
+|*Suspended* |Cluster is running but blocks all external requests. +
+This can happen when credits run out. Enter a credit card to return to the *Ready* state.
+--
+=====