DEALLOCATING is an irreversible server state (#2500)

Co-authored-by: Reneta Popova <[email protected]>

Author: jackwaudby

modules/ROOT/pages/clustering/databases.adoc

@@ -138,7 +138,7 @@ By default, a newly created database has both read and write access.
 [[deallocate-databases]]
 == Deallocate databases
 
-To relieve the load of a specific server(s), you can use one of the following procedures to deallocate databases causing the pressure from the server(s):
+To relieve the load of a specific server(s), you can use one of the following procedures to deallocate databases, causing the databases to be removed from the server(s) under pressure:
 
 * xref:procedures.adoc#procedure_dbms_cluster_deallocateDatabaseFromServer[`dbms.cluster.deallocateDatabaseFromServer("server-name", "database-name")`]
 * xref:procedures.adoc#procedure_dbms_cluster_deallocateDatabaseFromServers[`dbms.cluster.deallocateDatabaseFromServers(["server-name1", "server-name2"\], "database-name")`]

modules/ROOT/pages/clustering/servers.adoc

@@ -82,10 +82,16 @@ Once enabled, the server may be allocated databases to host.
 [[deallocating-state]]
 === Deallocating state
 
-When a server is no longer needed, it cannot be removed from the cluster while it is still allocated to host any databases.
+A server in a deallocating state means that it can no longer host databases.
+It may be that the server is no longer needed and you want to remove it from the cluster.
 The command `DEALLOCATE DATABASE[S] FROM SERVER[S] _server_[,...]` is used to transition servers to the _Deallocating_ state, reallocating all their hosted databases to other servers in the cluster.
-Additionally, servers which are deallocating will not have any further databases allocated to them.
+[NOTE]
+====
+This state is *irreversible*.
+Once a server is in a deallocating state, it subsequently cannot have databases allocated to it.
 
+If you want to deallocate databases from a server in a *reversible manner*, see xref:clustering/databases.adoc#deallocate-databases[Deallocate databases] for more information.
+====
 
 === Deallocated state