Merge pull request rook#14752 from travisn/config-doc

docs: Declare cephconfig settings stable

Documentation/CRDs/Cluster/ceph-cluster-crd.md

@@ -825,9 +825,6 @@ set the `allowUninstallWithVolumes` to true under `spec.CleanupPolicy`.
 
 ## Ceph Config
 
-!!! attention
-    This feature is experimental.
-
 The Ceph config options are applied after the MONs are all in quorum and running.
 To set Ceph config options, you can add them to your `CephCluster` spec as shown below.
 See the [Ceph config reference](https://docs.ceph.com/en/latest/rados/configuration/general-config-ref/)
@@ -848,6 +845,17 @@ spec:
       osd_max_scrubs: "10"
 ```
 
+The Rook operator will actively apply these values, whereas the
+[ceph.conf settings](../../Storage-Configuration/Advanced/ceph-configuration/#custom-cephconf-settings)
+only take effect after the Ceph daemon pods are restarted.
+
+If both these `cephConfig` and [ceph.conf settings](../../Storage-Configuration/Advanced/ceph-configuration/#custom-cephconf-settings)
+are applied, the `cephConfig` settings will take higher precedence if there is an overlap.
+
+If Ceph settings need to be applied to mons before quorum is initially created, the
+[ceph.conf settings](../../Storage-Configuration/Advanced/ceph-configuration/#custom-cephconf-settings)
+should be used instead.
+
 !!! warning
     Rook performs no direct validation on these config options, so the validity of the settings is the
     user's responsibility.

Documentation/Storage-Configuration/Advanced/ceph-configuration.md

@@ -208,7 +208,7 @@ ceph osd pool set rbd pg_num 512
 
 ## Custom `ceph.conf` Settings
 
-!!! warning
+!!! info
     The advised method for controlling Ceph configuration is to use the [`cephConfig:` structure](../../CRDs/Cluster/ceph-cluster-crd.md#ceph-config)
     in the `CephCluster` CRD.
     <br><br>It is highly recommended that this only be used when absolutely necessary and that the `config` be