diff --git a/dbx/docker-replica-set.rst b/dbx/docker-replica-set.rst
index 382e246..fdd9c24 100644
--- a/dbx/docker-replica-set.rst
+++ b/dbx/docker-replica-set.rst
@@ -1,4 +1,8 @@
-.. note:: Replica Set in Docker
+When a replica set runs in Docker, it might expose only one MongoDB endpoint.
+In this case, the replica set is not discoverable. Specifying ``directConnection=false`` in your connection URI,
+or leaving this option unset, can prevent your application from connecting to it.
 
-   To connect to a replica set running in one or more Docker containers,
-   specify ``directConnection=true`` in your connection URI.
\ No newline at end of file
+In a test or development environment, you can connect to the replica set by specifying
+``directConnection=true``. In a production environment, we
+recommend configuring the cluster to make each MongoDB instance accessible outside of
+the Docker virtual network.
\ No newline at end of file