DOCS-15002 deprecation warnings v5.2 (#341)

* DOCSP-15002 Deprecation warnings

* Review feedback

Author: Dave

source/reference/method/db.getSiblingDB.txt

@@ -15,26 +15,17 @@ Definition
 
 .. method:: db.getSiblingDB(<database>)
 
-
    .. list-table::
       :header-rows: 1
       :widths: 20 20 80
 
       * - Parameter
-   
         - Type
-   
         - Description
 
       * - ``database``
-   
         - string
-   
         - The name of a MongoDB database.
-          
-          
-   
-
 
    :returns: A database object.
 
@@ -47,33 +38,49 @@ Example
 You can use :method:`db.getSiblingDB()` as an alternative to the ``use
 <database>`` helper. This is particularly useful when writing scripts
 using :binary:`~bin.mongosh` where the ``use`` helper is not
-available. Consider the following sequence of operations:
+available. 
+
+Consider a MongoDB instance with two databases, ``users`` and
+``records``. The ``active`` collection is a part of the ``users``
+database. The ``requests`` collection is a part of the ``records``
+database.
+
+Specify a Database
+~~~~~~~~~~~~~~~~~~
+
+This operation sets the ``db`` object to point to the database named
+``users``, and then returns a :method:`document count
+<db.collection.countDocuments>` for the ``active`` collection.
 
 .. code-block:: javascript
 
    db = db.getSiblingDB('users')
-   db.active.count()
+   db.active.countDocuments()
 
-This operation sets the ``db`` object to point to the database named
-``users``, and then returns a :doc:`count
-</reference/method/db.collection.count>` of the collection named
-``active``. You can create multiple ``db`` objects, that refer to
-different databases, as in the following sequence of operations:
+Use Multiple Databases
+~~~~~~~~~~~~~~~~~~~~~~
+
+You can create multiple ``db`` objects, that refer to different
+databases, as in the following sequence of operations:
 
 .. code-block:: javascript
 
    users = db.getSiblingDB('users')
    records = db.getSiblingDB('records')
 
-   users.active.count()
+   users.active.countDocuments()
    users.active.findOne()
 
-   records.requests.count()
+   records.requests.countDocuments()
    records.requests.findOne()
 
-This operation creates two ``db`` objects referring to different
-databases (i.e. ``users`` and ``records``) and then returns a
-:doc:`count </reference/method/db.collection.count>` and an
-:doc:`example document </reference/method/db.collection.findOne>` from
-one collection in that database (i.e. ``active`` and ``requests``
-respectively.)
+This operation creates two ``db`` objects. Each ``db`` object refers to
+a different database, ``users`` or ``records``.
+
+For each database, the query returns:
+
+- a :method:`document count <db.collection.countDocuments>`, and 
+- an :method:`example document <db.collection.findOne>`
+
+from a collection in that database.
+