DOCS-5898 add examples for dropDatabase

Author: kay-kim

source/reference/command/dropDatabase.txt

@@ -4,26 +4,43 @@ dropDatabase
 
 .. default-domain:: mongodb
 
+Definition
+----------
+
 .. dbcommand:: dropDatabase
 
    The :dbcommand:`dropDatabase` command drops the current database, deleting
    the associated data files.
 
-   .. include:: /includes/fact-drop-database-users.rst
-
-   To run this command, issue the ``use <database>`` command in the shell,
-   replacing ``<database>`` with the name of the database you wish to delete.
-   Then use the following command form:
+   The command has the following form:
 
    .. code-block:: javascript
 
       { dropDatabase: 1 }
 
-   The :program:`mongo` shell also provides the following equivalent helper method
+   The :program:`mongo` shell also provides the helper method
    :method:`db.dropDatabase()`.
 
-   .. include:: /includes/warning-blocking-global.rst
+Behavior
+--------
+
+.. include:: /includes/warning-blocking-global.rst
+
+.. include:: /includes/fact-drop-database-users.rst
+
+Example
+-------
+
+The following example in the :program:`mongo` shell uses the ``use
+<database>`` operation to switch the current database to the ``temp``
+database and then uses the :dbcommand:`dropDatabase` command to drop
+the ``temp`` database:
+
+.. code-block:: javascript
+
+   use temp
+   db.runCommand( { dropDatabase: 1 } )
 
-   .. write-lock
+.. write-lock
 
 .. seealso:: :dbcommand:`dropAllUsersFromDatabase`

source/reference/method/db.dropDatabase.txt

@@ -4,12 +4,34 @@ db.dropDatabase()
 
 .. default-domain:: mongodb
 
+Definition
+----------
+
 .. method:: db.dropDatabase()
 
-   Removes the current database. Does not change the current database,
-   so the insertion of any documents in this database will allocate a
-   fresh set of data files.
+   Removes the current database, deleting the associated data files.
+
+Behavior
+--------
+
+The :method:`db.dropDatabase()` wraps the :dbcommand:`dropDatabase`
+command.
+
+.. include:: /includes/warning-blocking-global.rst
+
+.. include:: /includes/fact-drop-database-users.rst
+
+Example
+-------
+
+The following example in the :program:`mongo` shell uses the ``use
+<database>`` operation to switch the current database to the ``temp``
+database and then uses the :method:`db.dropDatabase()` method to drops
+the ``temp`` database:
+
+.. code-block:: javascript
 
-   .. include:: /includes/fact-drop-database-users.rst
+   use temp
+   db.dropDatabase()
 
 .. seealso:: :dbcommand:`dropDatabase`