Doscp 14337 (#147)

DOCSP-14337: gssapiServiceName query parameter is deprecated

Author: biniona-mongodb

source/fundamentals/authentication/enterprise-mechanisms.txt

@@ -21,10 +21,21 @@ parameters of the
 :manual:`connection string </reference/connection-string/>`:
 
 - Set the ``authMechanism`` parameter to ``GSSAPI``
-- Set the ``gssapiServiceName`` if using a value other than ``mongodb``
+- Set the ``SERVICE_NAME`` value in the ``authMechanismProperties``
+  parameter if using a value other than ``mongodb``
 - Specify a ``SERVICE_REALM`` value in the ``authMechanismProperties``
   parameter if a custom service realm is required.
 
+.. important::
+   
+   The ``gssapiServiceName`` parameter is deprecated and may be removed
+   in future versions of the driver. Use
+   ``authMechanismProperties=SERVICE_NAME:<your service name>`` in the
+   connection URI instead.
+   See the
+   :manual:`authMechanismProperties </reference/connection-string/#urioption.authMechanismProperties>`
+   parameter documentation for more information.
+
 The following code sample authenticates to Kerberos for UNIX using ``GSSAPI``.
 
 .. important::