DOCSP-31290: ssl options deprecated in v6.0 (#731)

* DOCSP-31290-ssl-deprecation-v6.0

* highlighting fix

* small fix

* CC suggestions

Author: rustagir

source/fundamentals/authentication/mechanisms.txt

@@ -281,11 +281,16 @@ Pass the location of your client certificate file as the value of
 .. literalinclude:: /code-snippets/authentication/x509.js
    :language: javascript
 
-TLS/SSL Options
-~~~~~~~~~~~~~~~
+.. tip::
+   
+   To learn more about enabling TLS on a connection, see
+   :ref:`node-connect-tls`.
+
+TLS Options
+~~~~~~~~~~~
 
-The following table describes each of the TLS/SSL options that can be passed
-as a parameter in the connection URI.
+The following table describes the TLS options that you can set in a
+connection URI.
 
 .. list-table::
    :widths: 35 12 10 43
@@ -299,7 +304,7 @@ as a parameter in the connection URI.
    * - ``tls``
      - boolean
      - ``false``
-     - Specifies whether to use TLS/SSL connections.
+     - Specifies whether to enable TLS on the connection.
 
    * - ``tlsInsecure``
      - boolean

source/fundamentals/connection/tls.txt

@@ -189,16 +189,15 @@ You can include the filepaths for your certificates as client options to
 retrieve your certificates while connecting with TLS.
 
 The following code shows how to provide certificate filepaths as options
-in your ``MongoClient``: 
+in your ``MongoClient``:
 
 .. code-block:: js
-   :emphasize-lines: 4-6
+   :emphasize-lines: 4-5
 
    // Pass filepaths as client options
    const client = new MongoClient(uri, {
      tls: true,
      tlsCAFile: `<path to CA certificate>`,
-     tlsCertificateFile: `<path to public client certificate>`,
      tlsCertificateKeyFile: `<path to private client key>`,
    });
 

source/whats-new.txt

@@ -48,11 +48,21 @@ What's New in 6.0
 
 The {+driver-short+} v6.0 release includes the following features:
 
+.. important:: Deprecation Notice
+   
+   All of the ``ssl``-prefixed options in the ``MongoClientOptions``
+   type are deprecated. In addition, the ``tlsCertificateFile`` option
+   is deprecated.
+
+   Instead, you should store your certificates in a ``SecureContext``
+   object or set the ``tls``-prefixed options in your
+   ``MongoClientOptions`` instance. To learn more, see :ref:`node-connect-tls`.
+
 - Removes support for the ``addUser()`` helper command. Use the
   :manual:`createUser </reference/command/createUser>` MongoDB Shell command instead.
 - Removes support for the ``collStats`` operation. Use the
   :manual:`$collStats </reference/operator/aggregation/collStats>` aggregation operator
-  instead. 
+  instead.
 
 .. _version-5.7: