run command

Author: rachel-mack

source/command.txt

@@ -2,7 +2,13 @@
 Run a Command
 =============
 
-You can run all raw database operations using the
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+In this guide, you can learn how to run raw database operations using the
 ``MongoDatabase.runCommand()`` method. A raw database operation is a
 command you can execute directly on the {+mdb-server+} CLI. These
 commands include administrative and diagnostic tasks, such as fetching
@@ -28,18 +34,17 @@ By default, ``runCommand`` returns an object of type
 can specify a return type for ``runCommand()`` as an optional second
 parameter.
 
-Example
--------
+Run Command Example: Full File
+------------------------------
 
 In the following sample code, we send the ``dbStats`` command to request
 statistics from a specific MongoDB database.
 
 .. include:: /includes/connect-guide-note.rst
 
-.. literalinclude:: /includes/usage-examples/code-snippets/Command.java
+.. literalinclude:: /includes/Command.java
   :language: java
 
-
 When you run the preceding command, you should see output similar to the
 following:
 
@@ -50,9 +55,18 @@ following:
 
 .. include:: /includes/legacy-redirect.rst
 
-For additional information on the classes and methods mentioned on this
-page, see the following resources:
+Additional Information
+----------------------
+
+API Documentation
+~~~~~~~~~~~~~~~~~
+
+For additional information on the classes and methods used to run database commands, see the following API documentation:
+
+- `runCommand() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoDatabase.html#runCommand(org.bson.conversions.Bson)>`__ 
+  
+Server Manual Entries
+~~~~~~~~~~~~~~~~~~~~~
 
-- `runCommand() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoDatabase.html#runCommand(org.bson.conversions.Bson)>`__ API Documentation
-- :manual:`Database Commands </reference/command/>` Server Manual Entry
-- :manual:`dbStats </reference/command/dbStats/>` Server Manual Entry
+- :manual:`Database Commands </reference/command/>`
+- :manual:`dbStats </reference/command/dbStats/>`

source/crud/read-operations.txt

@@ -16,6 +16,7 @@ Read Operations
    Skip Returned Results </crud/read-operations/skip>
    Limit Returned Results </crud/read-operations/limit>
    Specify Fields to Return </crud/read-operations/project>
+   Count Documents </crud/read-operations/count>
    Geospatial Data </crud/read-operations/geo>
    Search Text </crud/read-operations/text>
 
@@ -25,5 +26,6 @@ Read Operations
 - :doc:`/crud/read-operations/skip`
 - :doc:`/crud/read-operations/limit`
 - :doc:`/crud/read-operations/project`
+- :doc:`/crud/read-operations/count`
 - :doc:`/crud/read-operations/geo`
 - :doc:`/crud/read-operations/text`

source/crud/read-operations/count.txt

@@ -8,7 +8,7 @@ Count Documents
 .. contents:: On this page
    :local:
    :backlinks: none
-   :depth: 1
+   :depth: 2
    :class: singlecol
 
 In this guide, you can learn how to count documents in your MongoDB
@@ -80,8 +80,8 @@ specify the behavior of the call:
 
 Both methods return the number of matching documents as a ``long`` primitive.
 
-Example
--------
+Count Documents Example: Full File
+----------------------------------
 
 The following example estimates the number of documents in the
 ``movies`` collection in the ``sample_mflix`` database, and then returns
@@ -104,10 +104,21 @@ like this (exact numbers can vary depending on your data):
 
 .. include:: /includes/legacy-redirect.rst
 
-For additional information on the classes and methods mentioned on this
-page, see the following API Documentation:
+Additional Information
+----------------------
+
+API Documentation
+~~~~~~~~~~~~~~~~~
+
+For additional information on the classes and methods used to count documents, see the following API documentation:
 
 - `countDocuments() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#countDocuments()>`__
 - `estimatedDocumentCount() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#estimatedDocumentCount()>`__
 - `CountOptions <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/CountOptions.html>`__
 - `EstimatedDocumentCountOptions <{+api+}/apidocs/mongodb-driver-core/com/mongodb/client/model/EstimatedDocumentCountOptions.html>`__
+
+Server Manual Entries
+~~~~~~~~~~~~~~~~~~~~~
+
+- :manual:`db.collection.countDocuments() </reference/method/db.collection.countDocuments/>`
+- :manual:`db.collection.estimatedDocumentCount() </reference/method/db.collection.estimatedDocumentCount/>`

source/includes/crud/Command.java renamed to source/includes/RunCommand.java

@@ -1,6 +1,4 @@
-// Runs a database command by using the Java driver
-
-package usage.examples;
+package org.example;
 
 import org.bson.BsonDocument;
 import org.bson.BsonInt64;

source/logging-monitoring/change-streams.txt

@@ -465,11 +465,11 @@ API documentation.
 Additional Information
 ----------------------
 
-To learn more about the methods and classes used to manage change streams, see the following API documentation:
-
 API Documentation
 ~~~~~~~~~~~~~~~~~
 
+To learn more about the methods and classes used to manage change streams, see the following API documentation:
+
 - `MongoCollection.watch() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoCollection.html#watch()>`__ 
 - `MongoDatabase.watch() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoDatabase.html#watch()>`__ 
 - `MongoClient.watch() <{+api+}/apidocs/mongodb-driver-sync/com/mongodb/client/MongoClient.html#watch()>`__