DOCSP-32942: Deprecated Methods (#446)

* DOCSP-32942: Deprecated Methods

* review feedback

* DOCSP-33241: fix extended JSON example id field (#447)

* DOCSP-33241: fix extended JSON example id field

* DOCSP-31694: SOCKS5 proxy support (#439)

* DOCSP-31694: SOCKS5 proxy support

* DOCSP-33300: Fix aggregation operator links to the manual (#448)

* DOCSP-32300 Adds compatibility info to landing page (#449)

* DOCSP-31907 Split Event (#457)

* tech review feedback

* format

* CC feedback

* CC feedback pt 2

* DOCSP-31907 - Add paragraph from server docs (#460)

* DOCSP-32942: Deprecated Methods

* review feedback

* tech review feedback

* format

* CC feedback

* CC feedback pt 2

* build

source/whats-new.txt

@@ -74,6 +74,28 @@ What's New in 4.11
 
 .. New features of the 4.11 driver release include:
 
+- The following network address-related methods are deprecated and will be removed
+  in v5.0:
+
+  - The `ServerAddress <{+api+}/apidocs/mongodb-driver-core/com/mongodb/ServerAddress.html>`__
+    methods ``getSocketAddress()`` and ``getSocketAddresses()``.
+
+    Instead of ``getSocketAddress()``, use the ``getByName()`` instance
+    method of ``java.net.InetAddress``.
+
+    Instead of ``getSocketAddresses()``, use the ``getAllByName()`` instance
+    method of ``java.net.InetAddress``.
+
+  - The `UnixServerAddress <{+api+}/apidocs/mongodb-driver-core/com/mongodb/UnixServerAddress.html>`__
+    method ``getUnixSocketAddress()``.
+
+    Instead of ``getUnixSocketAddress()``, construct an instance of
+    ``jnr.unixsocket.UnixSocketAddress``. Pass the full path of the UNIX
+    socket file to the constructor. By default, MongoDB creates a UNIX
+    socket file located at ``"/tmp/mongodb-27017.sock"``. To learn more
+    about the ``UnixSocketAddress``, see the `UnixSocketAddress API documentation
+    <https://www.javadoc.io/doc/com.github.jnr/jnr-unixsocket/latest/jnr/unixsocket/UnixSocketAddress.html>`__.
+
 .. _version-4.10:
 
 What's New in 4.10