From the discussion brought up in this [issue](https://github.com/coreos/prometheus-operator/issues/2250), a new section has been added to the doc.