Description of problem:

Currently, we have the following titles in the deployment guide

  6. UPGRADING YOUR RED HAT OPENSHIFT CONTAINER STORAGE IN CONVERGED MODE
6.1. UPGRADING THE GLUSTERFS PODS
6.2. UPGRADING HEKETI AND GLUSTERFS REGISTRY PODS
6.3. UPGRADING THE CLIENT ON RED HAT OPENSHIFT CONTAINER PLATFORM NODES
6.4. STARTING THE HEKETI PODS
  7. UPGRADING YOUR RED HAT OPENSHIFT CONTAINER STORAGE IN INDEPENDENT MODE
7.1. PREREQUISITES
7.2. UPGRADING YOUR INDEPENDENT MODE SETUP
7.3. UPGRADING GLUSTER NODES AND HEKETI PODS IN GLUSTERFS REGISTRY NAMESPACE
7.4. UPGRADING THE CLIENT ON RED HAT OPENSHIFT CONTAINER PLATFORM NODES


IMO, the differentiation between 6.1 and 6.2 is incorrect. Similarly, the differentiation between 7.2 and 7.3 is incorrect. The emphasis seems to be on Gluster and Heketi parts whereas the emphasis should be on the glusterfs namespace and the glusterfs_registry namespace. 

Titles that I propose are:

  6. UPGRADING YOUR RED HAT OPENSHIFT CONTAINER STORAGE IN CONVERGED MODE
6.1. UPGRADING THE PODS IN THE GLUSTERFS GROUP
6.2. UPGRADING THE PODS IN THE GLUSTERFS_REGISTRY GROUP
6.3. UPGRADING THE CLIENT ON RED HAT OPENSHIFT CONTAINER PLATFORM NODES
6.4. STARTING THE HEKETI PODS
  7. UPGRADING YOUR RED HAT OPENSHIFT CONTAINER STORAGE IN INDEPENDENT MODE
7.1. PREREQUISITES
7.2. UPGRADING NODES AND PODS IN GLUSTERFS GROUP
7.3. UPGRADING NODES AND PODS IN GLUSTERFS REGISTRY GROUP
7.4. UPGRADING THE CLIENT ON RED HAT OPENSHIFT CONTAINER PLATFORM NODES