In documentation clarify the purpose behind client creation. (#320)

Co-authored-by: Steven Silvester <[email protected]> Co-authored-by: Steven Silvester <[email protected]>
mongodb · Jan 29, 2025 · 9cf90a8 · 9cf90a8
1 parent 0259b9f
commit 9cf90a8
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 3 deletions.
diff --git a/doc/tutorial-asyncio.rst b/doc/tutorial-asyncio.rst
@@ -78,7 +78,9 @@ Motor, like PyMongo, represents data with a 4-level object hierarchy:
 
 Creating a Client
 -----------------
-You typically create a single instance of :class:`~motor.motor_asyncio.AsyncIOMotorClient` at the time your
+Creating a client is what establishes a connection to MongoDB and tells your
+app what deployment (i.e. cluster) to connect to. You typically create a single
+instance of :class:`~motor.motor_asyncio.AsyncIOMotorClient` at the time your
 application starts up.
 
 .. doctest:: before-inserting-2000-docs

diff --git a/doc/tutorial-tornado.rst b/doc/tutorial-tornado.rst
@@ -86,8 +86,9 @@ Motor, like PyMongo, represents data with a 4-level object hierarchy:
 
 Creating a Client
 -----------------
-You typically create a single instance of :class:`MotorClient` at the time your
-application starts up.
+Creating a client is what establishes a connection to MongoDB and tells your
+app what deployment (i.e. cluster) to connect to. You typically create a single
+instance of :class:`MotorClient` at the time your application starts up.
 
 .. doctest:: before-inserting-2000-docs