Merge pull request #18 from rustagir/DOCSP-37862-command

DOCSP-37862: command tutorial

Author: rustagir

source/get-started/pojo-qs.txt

@@ -340,6 +340,4 @@ The following example deletes all ``Person`` instances that have an
 Additional Information
 ~~~~~~~~~~~~~~~~~~~~~~
 
-.. 
-   TODO update link
-   To find additional tutorials, see the :ref:`Tutorials <>` section.
+To find additional tutorials, see the :ref:`javars-tutorials` section.

source/get-started/primer.txt

@@ -14,8 +14,6 @@ This guide provides background about the {+driver-short+} and its
 asynchronous API before showing you how to use the driver and MongoDB in
 the :ref:`Quick Start guide <javars-quickstart>`.
 
-.. TODO fix ref above when QS is made
-
 .. note::
 
    See the :ref:`Installation guide <javars-install>`

source/get-started/quickstart.txt

@@ -536,14 +536,12 @@ The following example creates an ascending index on the ``i`` field:
    collection.createIndex(new Document("i", 1))
        .subscribe(new PrintSubscriber<String>("Create Index Result: %s"));
 
-.. TODO For a list of other index types, see the :ref:`Indexes <>` guide.
+To view a list of other index types, see the :ref:`javars-indexes` guide.
 
 Additional Information
 ----------------------
 
 For additional tutorials that demonstrate how to use MongoDB with POJOs,
 see the :ref:`Quick Start (POJO Examples) guide <javars-pojo-qs>`.
 
-.. 
-   TODO update link
-   To find additional tutorials, see the :ref:`Tutorials <>` section.
+To find additional tutorials, see the :ref:`javars-tutorials` section.

source/tutorials.txt

@@ -17,4 +17,5 @@ Tutorials
    /tutorials/text-search/
    /tutorials/geo/
    /tutorials/gridfs/
+   /tutorials/command/
 

source/tutorials/aggregation.txt

@@ -49,7 +49,7 @@ this guide:
 Connect to a MongoDB Deployment
 -------------------------------
 
-First, connect to a MongoDB deployment and declare and define
+First, connect to a MongoDB deployment, then declare and define
 ``MongoDatabase`` and ``MongoCollection`` instances.
 
 The following code connects to a standalone

source/tutorials/change-stream.txt

@@ -53,7 +53,7 @@ this guide:
 Connect to a MongoDB Deployment
 -------------------------------
 
-First, connect to a MongoDB deployment and declare and define
+First, connect to a MongoDB deployment, then declare and define
 ``MongoDatabase`` and ``MongoCollection`` instances.
 
 The following code connects to a standalone

source/tutorials/command.txt

@@ -0,0 +1,73 @@
+.. _javars-run-command:
+
+============
+Run Commands
+============
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+Not all database commands have a specific helper method. However, you can
+run any MongoDB command by using the ``MongoDatabase.runCommand()``
+method.
+
+To learn more about MongoDB commands, see :manual:`Database Commands </reference/command/>`
+in the Server manual.
+
+Prerequisites
+-------------
+
+You must set up the following components to run the code examples in
+this guide:
+
+- A ``test.restaurants`` collection populated with documents from the
+  ``restaurants.json`` file in the `documentation assets GitHub
+  <https://raw.githubusercontent.com/mongodb/docs-assets/drivers/restaurants.json>`__.
+
+- The following import statements:
+
+.. code-block:: java
+
+   import com.mongodb.reactivestreams.client.MongoClients;
+   import com.mongodb.reactivestreams.client.MongoClient;
+   import com.mongodb.reactivestreams.client.MongoDatabase;
+   import org.bson.Document;
+   
+.. important::
+
+   This guide uses the ``Subscriber`` implementations, which are
+   described in the :ref:`Quick Start Primer <javars-primer>`.
+
+Connect to a MongoDB Deployment
+-------------------------------
+
+First, connect to a MongoDB deployment, then declare and define
+a ``MongoDatabase`` instance.
+
+The following code connects to a standalone
+MongoDB deployment running on ``localhost`` on port ``27017``. Then, it
+defines the ``database`` variable to refer to the ``test`` database:
+
+.. code-block:: java
+
+   MongoClient mongoClient = MongoClients.create();
+   MongoDatabase database = mongoClient.getDatabase("test");
+
+To learn more about connecting to MongoDB deployments,
+see the :ref:`javars-connect` tutorial.
+
+Run the buildInfo Command
+-------------------------
+
+To run the ``buildInfo`` command, construct a ``Document`` object that
+specifies the command and pass it as a paramter to the ``runCommand()`` method.
+
+The following sample code runs the ``buildInfo`` command and prints
+the results:
+
+.. code-block:: java
+
+   database.runCommand(new Document("buildInfo", 1)).subscribe(new PrintDocumentSubscriber());

source/tutorials/db-coll.txt

@@ -193,7 +193,8 @@ properties, such as different :manual:`read concerns
 - ``MongoCollection.withReadPreference()``
 - ``MongoCollection.withWriteConcern()``
 
-.. TODO To learn more, see the `Read Operations` and `Write Operations` tutorials.
+To learn more, see the :ref:`javars-read-operations` and
+:ref:`javars-write-ops` tutorials.
 
 CodecRegistry
 -------------

source/tutorials/indexes.txt

@@ -50,7 +50,7 @@ code examples in this guide:
 Connect to a MongoDB Deployment
 -------------------------------
 
-First, connect to a MongoDB deployment and declare and define
+First, connect to a MongoDB deployment, then declare and define
 ``MongoDatabase`` and ``MongoCollection`` instances.
 
 The following code connects to a standalone

source/tutorials/read-ops.txt

@@ -51,7 +51,7 @@ this guide:
 Connect to a MongoDB Deployment
 -------------------------------
 
-First, connect to a MongoDB deployment and declare and define
+First, connect to a MongoDB deployment, then declare and define
 ``MongoDatabase`` and ``MongoCollection`` instances.
 
 The following code connects to a standalone
@@ -189,8 +189,8 @@ provides the ``Projections`` class.
 In the projection document, you can also specify a projection
 expression by using a projection operator.
 
-.. TODO update link To view an example that uses the ``Projections.metaTextScore()`` method, see the
-.. :ref:`Text Search <>` tutorial.
+To view an example that uses the ``Projections.metaTextScore()`` method, see the
+:ref:`javars-text-search` tutorial.
 
 Sorts
 ~~~~~