Standardization (#66)

Author: shuangela

snooty.toml

@@ -8,8 +8,11 @@ intersphinx = [ "https://www.mongodb.com/docs/manual/objects.inv",
 sharedinclude_root = "https://raw.githubusercontent.com/10gen/docs-shared/main/"
 
 toc_landing_pages = [
-    "/tutorials/connect/",
-    "/tutorials/write-ops/",
+    "/connect/",
+    "/read-data-from-mongo/",
+    "/write-data-to-mongo/",
+    "/getting-started/",
+    "/secure-your-data/"
     ]
 
 [constants]
@@ -20,3 +23,8 @@ full-version = "{+version+}.3"
 api = "https://mongodb.github.io/mongo-java-driver/{+version+}/apidocs"
 rs-docs = "https://www.reactive-streams.org/reactive-streams-1.0.4-javadoc/org/reactivestreams"
 driver-source-gh = "https://github.com/mongodb/mongo-java-driver"
+java-rs = "Java Reactive Streams"
+string-data-type = "``String``"
+bool = "``boolean``"
+pr = "Project Reactor"
+mdb-server = "MongoDB Server"

source/tutorials/aggregation.txt renamed to source/aggregation.txt

@@ -1,4 +1,4 @@
-.. _javars-aggregation:
+.. _java-rs-aggregation:
 
 =====================
 Aggregation Framework

source/compatibility.txt

@@ -0,0 +1,47 @@
+.. _java-rs-compatibility:
+
+=============
+Compatibility
+=============
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+.. facet::
+   :name: genre
+   :values: reference
+ 
+.. meta::
+   :keywords: backwards compatibility, versions, upgrade 
+
+MongoDB Compatibility
+----------------------
+
+The following compatibility table specifies the recommended version or versions
+of the {+driver-short+} for use with a specific version of MongoDB.
+
+The first column lists the driver version.
+
+.. sharedinclude:: dbx/lifecycle-schedule-callout.rst
+
+.. sharedinclude:: dbx/compatibility-table-legend.rst
+
+.. include:: /includes/mongodb-compatibility-table-java-rs.rst
+
+Language Compatibility
+----------------------
+
+The following compatibility table specifies the recommended version or versions
+of the {+driver-short+} for use with a specific version of Java. Starting with
+Java 11, the table explicitly lists only Long-Term-Support (LTS) Java versions.
+
+The first column lists the driver version.
+
+.. include:: /includes/language-compatibility-table-java-rs.rst
+
+For more information on how to read the compatibility tables, see our guide on
+:driver:`MongoDB Compatibility Tables </about-compatibility/>`.
+

source/connect-to-mongo/choose-connection-target.txt

@@ -0,0 +1,145 @@
+.. _java-rs-connection-targets:
+
+==========================
+Choose a Connection Target
+==========================
+
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: connection string, URI, server, settings, client
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+Overview
+--------
+
+In this guide, you can learn how to use a connection string and a ``MongoClient`` object
+to connect to different types of MongoDB deployments.
+
+Atlas
+-----
+
+To connect to a MongoDB deployment on Atlas, include the following elements
+in your connection string:
+
+- URL of your Atlas cluster
+- MongoDB username
+- MongoDB password
+
+Then, pass your connection string to the ``create()`` method constructing a ``MongoClient`` object.
+
+.. tip::
+
+   Follow the :atlas:`Atlas driver connection guide </driver-connection>`
+   to retrieve your connection string.
+
+When you connect to Atlas, we recommend using the Stable API client option to avoid
+breaking changes when Atlas upgrades to a new version of MongoDB Server.
+To learn more about the Stable API feature, see :manual:`Stable API
+</reference/stable-api>` in the MongoDB Server manual.
+
+The following code shows how to use the {+driver-short+} to connect to an Atlas cluster. The
+code uses the ``serverApi`` option to specify a Stable API version. 
+
+.. include:: /includes/connect/connect-reactor.rst
+
+.. literalinclude:: /includes/connect/atlas-connection.java
+   :language: java
+
+Local Deployments
+-----------------
+
+To connect to a local MongoDB deployment, use ``localhost`` as the hostname. By
+default, the ``mongod`` process runs on port 27017, though you can customize this for
+your deployment.
+
+The following code shows how to use the {+driver-short+} to connect to a local MongoDB
+deployment:
+
+.. literalinclude:: /includes/connect/choose-connect-target.java
+   :start-after: start-connect-local
+   :end-before: end-connect-local
+   :language: java
+   :copyable:
+
+Replica Sets
+------------
+
+To connect to a replica set, specify the hostnames (or IP addresses) and 
+port numbers of the replica-set members in your connection string.
+
+If you aren't able to provide a full list of hosts in the replica set, you can 
+specify one or more of the hosts in the replica set and instruct the {+driver-short+} to 
+perform automatic discovery to find the others. To instruct the driver to perform
+automatic discovery, perform one of the following actions:
+
+- Specify the name of the replica set as the value of the ``replicaSet`` parameter.
+- Specify ``false`` as the value of the ``directConnection`` parameter.
+- Specify more than one host in the replica set.
+
+In the following example, the driver uses a sample connection URI to connect to the 
+MongoDB replica set ``sampleRS``, which is running on port ``27017`` of three different
+hosts, including ``host1``:
+
+.. literalinclude:: /includes/connect/choose-connect-target.java
+   :start-after: start-connect-replica
+   :end-before: end-connect-replica
+   :language: java
+   :copyable:
+
+.. note:: create() is Non-Blocking
+
+   The ``create()`` method constructing a ``MongoClient`` is *non-blocking*.
+   When you connect to a replica set, the method returns immediately while the
+   client uses background threads to connect to the replica set.
+   
+   If you create a ``MongoClient`` and immediately print the string representation
+   of its ``nodes`` attribute, the list might be empty while the client connects to
+   the replica-set members.
+
+Initialization
+~~~~~~~~~~~~~~
+
+To initialize a replica set, you must connect directly to a single member. To do so,
+set the ``directConnection`` connection
+option to ``True``. You can do this in the following ways:
+
+- Passing an argument to the ``create()`` method constructing a ``MongoClient``
+- Setting the parameter in your connection string.
+
+.. tabs::
+
+   .. tab:: MongoClient
+      :tabid: mongoclient
+
+      .. literalinclude:: /includes/connect/choose-connect-target.java
+         :start-after: start-arg-constructor
+         :end-before: end-arg-constructor
+         :language: java
+         :copyable:
+         :emphasize-lines: 7
+
+   .. tab:: Connection String
+      :tabid: connectionstring
+
+      .. literalinclude:: /includes/connect/choose-connect-target.java
+         :start-after: start-parameter-string
+         :end-before: end-parameter-string
+         :language: java
+         :copyable:
+         :emphasize-lines: 6
+
+API Documentation
+-----------------
+
+To learn more about creating a ``MongoClient`` instance in the {+driver-short+},
+see the following API documentation:
+
+- `MongoClient <{+api+}/mongodb-driver-reactivestreams/com/mongodb/reactivestreams/client/MongoClients.html>`__