(DOCSP-13890): TLS/x509 Cert Generation & Handling (#756)

Author: jwilliams-mongo

source/includes/admonitions/deprecate-cert-generation.rst

@@ -1,29 +1,26 @@
 .. important:: Deprecation Notice
 
-   The :setting:`spec.security.tls.secretRef.name`
-   and 
-   :opsmgrkube:`spec.applicationDatabase.security.tls.secretRef.name`
-   fields are deprecated for the MongoDB resources and for the
-   application database in the |onprem| resources. You can continue 
-   using :opsmgrkube:`spec.security.tls.secretRef.name`
-   for the |onprem| resources other than the application database.
+   The :setting:`spec.security.tls.secretRef.name`, 
+   :opsmgrkube:`spec.applicationDatabase.security.tls.secretRef.name`, 
+   and :opsmgrkube:`spec.security.tls.secretRef.name`
+   settings are deprecated.
 
-   This field will remain in future releases to maintain backwards
+   These fields will remain in future releases to maintain backwards
    compatibility.
 
-   If you omit
-   :opsmgrkube:`spec.applicationDatabase.security.tls.secretRef.name`,
+   If you omit these settings,
    the |k8s-op-short| expects the secrets that contain your
-   |tls| certificates for database resources to follow this naming 
-   convention: ``<metadata.name>-cert``, where ``<metadata.name>`` 
+   |tls| certificates to begin with: 
+   ``<metadata.name>``, where ``<metadata.name>`` 
    specifies the name of one of the following resources:
 
-   - |onprem| resource for application database deployments
+   - |onprem| resource for application database deployments and |onprem| resources
    - Database resource for other database deployments
 
-   For information about pre-pending an optional prefix to the secret
+   To learn more about adding an optional prefix to the secret
    name, see:
 
-   - :opsmgrkube:`spec.applicationDatabase.security.tls.secretRef.prefix`
+   - :opsmgrkube:`spec.applicationDatabase.security.certsSecretPrefix`
      for the application database in your |onprem| resources.
-   - :setting:`spec.security.tls.secretRef.prefix` for MongoDB resources.
+   - :opsmgrkube:`spec.security.certsSecretPrefix` for |onprem| resources.
+   - :setting:`spec.security.certsSecretPrefix` for MongoDB resources.