(DOCSP-7027): Clarifying behavior for unsupported mongod cmd line opt… (#94)

* (DOCSP-7027): Clarifying behavior for unsupported mongod cmd line options

* Updates per Chris' feedback

* Updates per Cian's feedback

Author: jeff-allen-mongo

source/includes/fact-unsupported-mongod-options.rst

@@ -0,0 +1,6 @@
+MongoDB custom resources do not support all
+:binary:`~bin.mongod` command line options. If you use an
+unsupported option in your object specification file, the backing
+:opsmgr:`MongoDB Agent </tutorial/nav/mongodb-agent/>`
+overrides the unsupported options. For a complete list of options
+supported by MongoDB custom resources, see :ref:`k8s-specification`.

source/includes/steps-deploy-k8s-replica-set-tls.yaml

@@ -82,6 +82,10 @@ content: |
 
   .. include:: /includes/list-table-requiressl-modes.rst
 
+  .. note::
+
+     .. include:: /includes/fact-unsupported-mongod-options.rst
+
 ---
 stepnum: 5
 level: 4

source/includes/steps-deploy-k8s-sharded-cluster.yaml

@@ -186,24 +186,8 @@ content: |
         - ``true``
 
 ---
-title: "If you wish to enable TLS on your sharded cluster, add the TLS settings to the ConfigMap."
-stepnum: 4
-level: 4
-ref: add-tls-settings-sc
-source:
-  file: steps-deploy-k8s-replica-set-tls.yaml
-  ref: add-tls-settings
-replacement:
-  example: |
-    The following example |k8s-configmap| configures a replica set to use
-    |tls|:
-
-    .. literalinclude:: /reference/k8s/example-sharded-cluster-tls.yaml
-       :language: yaml
-       :emphasize-lines: 19-25
----
 title: "Add any additional accepted settings for a :term:`sharded cluster` deployment."
-stepnum: 5
+stepnum: 4
 level: 4
 ref: add-k8s-values
 content: |
@@ -256,13 +240,13 @@ content: |
 
 ---
 title: "Save this file with a ``.yaml`` file extension."
-stepnum: 6
+stepnum: 5
 level: 4
 ref: save-object-spec
 
 ---
 title: "Start your :term:`sharded cluster` deployment."
-stepnum: 7
+stepnum: 6
 level: 4
 ref: start-k8s-sharded-cluster
 content: |
@@ -284,7 +268,7 @@ content: |
 
 ---
 title: "Track the status of your :term:`sharded cluster` deployment."
-stepnum: 8
+stepnum: 7
 level: 4
 ref: track-k8s-deployment
 content: |

source/tutorial/deploy-replica-set.txt

@@ -36,9 +36,6 @@ Prerequisites
 Considerations
 --------------
 
-Unique Names for Replica Set
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
 Use a unique name for the replica set.
 
 .. include:: /includes/important-unique-names-deployment-items.rst

source/tutorial/deploy-sharded-cluster.txt

@@ -36,9 +36,6 @@ Prerequisites
 Considerations
 --------------
 
-Unique Names for Sharded Clusters
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
 Use unique names for the new cluster and its shards.
 
 .. include:: /includes/important-unique-names-deployment-items.rst

source/tutorial/edit-deployment.txt

@@ -43,16 +43,21 @@ Procedure
 
       kubectl apply -f <standalone-conf>.yaml
 
-.. note::
+Considerations
+--------------
 
-   - Changes cannot be made to individual members of a replica set or
-     sharded cluster, only to the whole set or cluster.
+- Changes cannot be made to individual members of a replica set or
+  sharded cluster, only to the whole set or cluster.
 
-   - If a setting is not available for a MongoDB Kubernetes resource,
-     then the change must be made in the |application|.
+- If a setting is not available for a MongoDB Kubernetes resource,
+  then the change must be made in the |mms| or
+  `Cloud Manager <docs.cloudmanager.com/current/>`__ application.
+  
+  - .. include:: /includes/fact-unsupported-mongod-options.rst
 
-   - You can set some settings using |k8s-op-short| only. To review the
-     list of settings, see :doc:`/reference/k8s-op-exclusive-settings`.
+- Certain settings can only be configured using |k8s-op-short|. To
+  review the list of settings,
+  see :doc:`/reference/k8s-op-exclusive-settings`.
 
 .. toctree::
    :titlesonly:

source/tutorial/upgrade-mdb-version.txt

@@ -91,5 +91,5 @@ upgrade the deployment's MongoDB version to ``4.0.6``:
 |k8s| automatically reconfigures your deployment with the new
 specifications. You can see these changes reflected in the
 |mms| or `Cloud Manager <docs.cloudmanager.com/current/>`__
-:abbr:`UI (User Interface)`.
+application.