=doc #3539 Update the cluster spec (backport)

* The cluster spec has been rearranged into two sections describing the
current cluster and future enhancements/additions.
* The state diagram has been replaced with a new one describing the current
cluster implementation.
* A number of small additons and changes to the text.