DOCSP-16494 consistent purpose statements (#103)

kyuan-mongodb · web-flow · commit acf720c196d3 · 2021-06-17T16:21:20.000-04:00
* changed/made purpose statements to be consistent
diff --git a/source/fundamentals/aggregation.txt b/source/fundamentals/aggregation.txt
@@ -15,6 +15,8 @@ Overview
 
 .. _java-aggregation:
 
+In this guide, you can learn how to use **aggregation operations** in the MongoDB Java driver.
+
 Aggregation operations process data in your MongoDB collections and return computed results. MongoDB's Aggregation
 framework is modeled on the concept of data processing pipelines. Documents enter a multi-staged pipeline that
 transforms the documents into an aggregated result.
diff --git a/source/fundamentals/auth.txt b/source/fundamentals/auth.txt
@@ -13,8 +13,8 @@ Authentication Mechanisms
 Overview
 --------
 
-In this guide, we show you how to authenticate with MongoDB using each
-**authentication mechanism** available in MongoDB Community Edition.
+In this guide, you can learn how to authenticate with MongoDB using each
+**authentication mechanism** available in the MongoDB Community Edition.
 Authentication mechanisms are processes by which the driver and server
 confirm identity and establish trust to ensure security.
 
diff --git a/source/fundamentals/builders/aggregates.txt b/source/fundamentals/builders/aggregates.txt
@@ -15,9 +15,9 @@ Aggregates Builders
 Overview
 --------
 
-This guide provides an overview of the :java-docs:`Aggregates <apidocs/mongodb-driver-core/com/mongodb/client/model/Aggregates>`
+In this guide, you can learn how to use the :java-docs:`Aggregates <apidocs/mongodb-driver-core/com/mongodb/client/model/Aggregates>`
 class which provides static factory methods that build :manual:`aggregation pipeline
-stages </reference/operator/aggregation/>`.
+stages </reference/operator/aggregation/>` in the MongoDB Java driver.
 
 For a more thorough introduction to Aggregation, see our :ref:`Aggregation guide <java-aggregation>`.
 
diff --git a/source/fundamentals/builders/filters.txt b/source/fundamentals/builders/filters.txt
@@ -15,8 +15,8 @@ Filters Builders
 Overview 
 --------
 
-In this guide, we show you how to use **builders** to specify
-**filters** for your queries.
+In this guide, you can learn how to use **builders** to specify
+**filters** for your queries in the MongoDB Java driver.
 
 Builders are classes provided by the MongoDB Java driver that help you
 construct :ref:`Bson <bson>` objects. To learn more, see our :doc:`guide
diff --git a/source/fundamentals/builders/indexes.txt b/source/fundamentals/builders/indexes.txt
@@ -15,9 +15,10 @@ Indexes Builders
 Overview 
 --------
 
-In this guide, we show you how to specify **indexes** using the Java
-Driver :doc:`builders </fundamentals/builders/>`. Index builders provide
-helper methods for the following types of indexes: 
+In this guide, you can learn how to specify **indexes** using
+:doc:`builders </fundamentals/builders/>` in the MongoDB Java driver.
+The ``Indexes`` builder provides helper methods for constructing the
+following types of indexes:  
 
 - :ref:`Ascending Indexes <ascending-indexes>`
 - :ref:`Descending Indexes <descending-indexes>`
diff --git a/source/fundamentals/builders/projections.txt b/source/fundamentals/builders/projections.txt
@@ -15,8 +15,8 @@ Projections Builders
 Overview
 --------
 
-In this guide, we show you how to specify **projections** using the Java
-Driver :doc:`builders </fundamentals/builders/>`.
+In this guide, you can learn how to specify **projections** using
+:doc:`builders </fundamentals/builders/>` in the MongoDB Java driver.
 
 MongoDB supports **field projection**, specifying which fields to include and exclude when returning results from a
 query. Projection in MongoDB follows some basic rules:
diff --git a/source/fundamentals/builders/sort.txt b/source/fundamentals/builders/sort.txt
@@ -15,8 +15,8 @@ Sorts Builders
 Overview
 --------
 
-In this guide, we show you how to specify **sort criteria** for your
-queries using **builders**.
+In this guide, you can learn how to specify **sort criteria** for your
+queries using **builders** in the MongoDB Java driver.
 
 Sort criteria are the rules MongoDB uses to sort your data. Some
 examples of sort criteria are:
diff --git a/source/fundamentals/builders/updates.txt b/source/fundamentals/builders/updates.txt
@@ -15,8 +15,8 @@ Updates Builders
 Overview 
 --------
 
-This guide shows you how to specify **updates** using the Java Driver
-:doc:`builders </fundamentals/builders/>`. 
+In this guide, you can learn how to specify **updates** using
+:doc:`builders </fundamentals/builders/>` in the MongoDB Java driver.
 
 Update builders provide helper methods for the following types of updates:
 
diff --git a/source/fundamentals/collations.txt b/source/fundamentals/collations.txt
@@ -13,7 +13,7 @@ Collations
 Overview
 --------
 
-This guide shows you how to use **collations** with MongoDB to order your
+In this guide, you can learn how to use **collations** with MongoDB to order your
 query or aggregation operation results by string values. A collation is a set
 of character ordering and matching rules that apply to a specific language and
 locale.
diff --git a/source/fundamentals/connection.txt b/source/fundamentals/connection.txt
@@ -18,8 +18,8 @@ Connection Guide
 Overview
 --------
 
-This guide shows you how to connect to a MongoDB instance or replica set
-deployment using the driver.
+In this guide, you can learn how to connect to a MongoDB instance or
+replica set deployment using the MongoDB Java driver.
 
 For information about authenticating with a MongoDB instance,
 see :doc:`Authentication </fundamentals/auth>`. To learn more about using
diff --git a/source/fundamentals/connection/jndi.txt b/source/fundamentals/connection/jndi.txt
@@ -11,7 +11,10 @@ Java Naming and Directory Interface (JNDI)
 Overview
 --------
 
-``MongoClientFactory`` includes a `JNDI
+In this guide, you can learn how to connect the MongoDB Java driver
+to your MongoDB instance using a JNDI DataSource.
+
+MongoClientFactory includes a `JNDI
 <http://docs.oracle.com/javase/8/docs/technotes/guides/jndi/index.html>`__
 ``ObjectFactory`` implementation that returns ``MongoClient`` instances
 based on a :ref:`connection URI <connection-uri>`. Follow the guides
diff --git a/source/fundamentals/connection/tls.txt b/source/fundamentals/connection/tls.txt
@@ -11,7 +11,7 @@ Enable TLS/SSL on a Connection
 Overview
 --------
 
-You can connect to MongoDB instances with the
+In this guide, you can learn how to connect to MongoDB instances with the
 `TLS/SSL <https://en.wikipedia.org/wiki/Transport_Layer_Security>`__
 security protocol using the underlying TLS/SSL support in the JDK. To
 configure your connection to use TLS/SSL, enable the TLS/SSL settings in
diff --git a/source/fundamentals/crud/bulk.txt b/source/fundamentals/crud/bulk.txt
@@ -13,7 +13,7 @@ Bulk Operations
 Overview
 --------
 
-In this guide, you will learn how to use **bulk operations** in the
+In this guide, you can learn how to use bulk operations in the
 MongoDB Java Driver. 
 
 To perform a create, replace, update or delete (CRUD) operation, you
diff --git a/source/fundamentals/crud/compound-operations.txt b/source/fundamentals/crud/compound-operations.txt
@@ -13,8 +13,8 @@ Compound Operations
 Overview
 --------
 
-In this guide, you will learn how to perform **compound operations** with the
-MongoDB Java driver. 
+In this guide, you can learn how to perform **compound operations** with
+the MongoDB Java driver. 
 
 Compound operations consist of a read and write operation performed as one
 **atomic operation**. An atomic operation is an operation which either completes
diff --git a/source/fundamentals/crud/query-document.txt b/source/fundamentals/crud/query-document.txt
@@ -13,6 +13,9 @@ Specify a Query
 Overview 
 --------
 
+In this guide, you can learn how to specify a query in the MongoDB Java
+driver.
+
 Most CRUD operations allow you to narrow the set of matched documents by
 specifying matching criteria in a **query document**. Query documents
 contain one or more query operators that apply to specific fields which
diff --git a/source/fundamentals/crud/read-operations/cursor.txt b/source/fundamentals/crud/read-operations/cursor.txt
@@ -13,6 +13,9 @@ Access Data From a Cursor
 Overview
 --------
 
+In this guide, you can learn how to access data using a cursor with the
+MongoDB Java driver. 
+
 Read operations that return multiple documents do not immediately return
 all values matching the query. Because a query can potentially match
 large number of documents, we need to be able to access or store the
diff --git a/source/fundamentals/crud/read-operations/geo.txt b/source/fundamentals/crud/read-operations/geo.txt
@@ -13,7 +13,7 @@ Search Geospatially
 Overview
 --------
 
-On this page you will learn how to search **geospatial data** with the
+In this guide, you can learn how to search **geospatial data** with the
 MongoDB Java Driver, and the different geospatial data formats supported by MongoDB.
 
 Geospatial data is data that represents a geographical location on
diff --git a/source/fundamentals/crud/read-operations/limit.txt b/source/fundamentals/crud/read-operations/limit.txt
@@ -13,6 +13,9 @@ Limit the Number of Returned Results
 Overview
 --------
 
+In this guide, you can learn how to limit the number of results returned
+from read operations with the MongoDB Java driver.
+
 Use ``limit()`` to cap the number of documents that a read operation returns.
 This instance method designates the maximum number of
 documents that a read operation can return. If there are not enough documents
diff --git a/source/fundamentals/crud/read-operations/project.txt b/source/fundamentals/crud/read-operations/project.txt
@@ -13,8 +13,8 @@ Specify Which Fields to Return
 Overview
 --------
 
-In this guide, you will learn how to control which fields appear in
-documents returned by read operations.
+In this guide, you can learn how to control which fields appear in
+documents returned from read operations with the MongoDB Java driver.
 
 Many read requests require only a subset of fields in a document.
 For example, when logging a user in you may only need their username, and
diff --git a/source/fundamentals/crud/read-operations/skip.txt b/source/fundamentals/crud/read-operations/skip.txt
@@ -13,7 +13,8 @@ Skip Returned Results
 Overview
 --------
 
-In this guide, we show you how to skip a specified number of returned results.
+In this guide, you can learn how to skip a specified number of returned
+results from read operations with the MongoDB Java driver.
 
 You can skip results on the returned results of a query by using the
 ``skip()`` method. You can also skip documents at a specific stage in an
diff --git a/source/fundamentals/crud/read-operations/sort.txt b/source/fundamentals/crud/read-operations/sort.txt
@@ -13,8 +13,8 @@ Sort Results
 Overview
 --------
 
-In this guide, we show you how to use the **sort** operation to order your
-results.
+In this guide, you can learn how to use the **sort** operation to order your
+results from read operations with the MongoDB Java driver.
 
 The sort operation orders the documents returned from your query by your specified 
 **sort criteria**. Sort criteria are the rules you pass to MongoDB that describe
diff --git a/source/fundamentals/crud/write-operations/change-a-document.txt b/source/fundamentals/crud/write-operations/change-a-document.txt
@@ -13,8 +13,8 @@ Change a Document
 Overview
 --------
 
-In this page, you can learn how to change documents in a MongoDB collection
-using two distinct operation types: 
+In this guide, you can learn how to change documents in a MongoDB
+collection using two distinct operation types: 
 
 - :ref:`Update <update-operation>`
 - :ref:`Replace <replace-operation>`
diff --git a/source/fundamentals/crud/write-operations/delete.txt b/source/fundamentals/crud/write-operations/delete.txt
@@ -13,6 +13,9 @@ Delete a Document
 Overview
 --------
 
+In this guide, you can learn how to remove documents with the MongoDB Java
+driver.
+
 You can remove documents by passing a query filter to the
 ``deleteOne()``, ``deleteMany()`` or ``findOneAndDelete()`` methods. 
 
diff --git a/source/fundamentals/crud/write-operations/embedded-arrays.txt b/source/fundamentals/crud/write-operations/embedded-arrays.txt
@@ -13,7 +13,8 @@ Update Arrays in a Document
 Overview
 --------
 
-In this guide, you will learn how to update arrays in a document.
+In this guide, you can learn how to update arrays in a document with the
+MongoDB Java driver.
 
 To update an array, you must do the following:
 
diff --git a/source/fundamentals/crud/write-operations/insert.txt b/source/fundamentals/crud/write-operations/insert.txt
@@ -13,7 +13,8 @@ Insert Operations
 Overview
 --------
 
-In this guide, you will learn how to insert documents into MongoDB. 
+In this guide, you can learn how to insert documents with the MongoDB Java
+driver. 
 
 You can use MongoDB to retrieve, update and delete information. To
 perform any of those operations, that information, such as user profiles
diff --git a/source/fundamentals/crud/write-operations/upsert.txt b/source/fundamentals/crud/write-operations/upsert.txt
@@ -13,6 +13,9 @@ Insert or Update in a Single Operation
 Overview
 --------
 
+In this guide, you can learn how to perform an **upsert** with the
+MongoDB Java driver.
+
 Applications use insert and update operations to store and modify data.
 Sometimes, you need to choose between an insert and update depending on
 whether the document exists. MongoDB simplifies this decision for us
diff --git a/source/fundamentals/csfle.txt b/source/fundamentals/csfle.txt
@@ -13,8 +13,11 @@ Client-Side Field Level Encryption
 Overview
 --------
 
-Client-Side Field Level Encryption (CSFLE) allows you to encrypt
-specific data fields within a document with your MongoDB client application before sending the data to the server.
+In this guide, you can learn how to install and use **Client-Side Field
+Level Encryption (CSFLE)** in the MongoDB Java driver.
+
+CSFLE allows you to encrypt specific data fields within a document with
+your MongoDB client application before sending the data to the server.
 Starting in MongoDB 4.2 Enterprise, you can perform this client-side encryption automatically.
 
 With CSFLE, your client application encrypts fields client-side without requiring any server-side configuration or
diff --git a/source/fundamentals/data-formats/codecs.txt b/source/fundamentals/data-formats/codecs.txt
@@ -17,8 +17,8 @@ Overview
 --------
 
 In this guide, you can learn about **Codecs** and the supporting classes that
-handle the encoding and decoding of Java objects to and from BSON data in
-MongoDB. The ``Codec`` abstraction allows you to map any Java type to
+handle the encoding and decoding of Java objects to and from BSON data
+in the MongoDB Java driver. The ``Codec`` abstraction allows you to map any Java type to
 a corresponding BSON type. You can use this to map your domain objects
 directly to and from BSON instead of using an intermediate map-based object such
 as ``Document`` or ``BsonDocument``.
diff --git a/source/fundamentals/data-formats/document-data-format-bson.txt b/source/fundamentals/data-formats/document-data-format-bson.txt
@@ -15,8 +15,9 @@ Document Data Format: BSON
 Overview
 --------
 
-This guide explains the BSON data format, how MongoDB uses it, and how to
-install the BSON library independently of the MongoDB Java driver.
+In this guide, you can learn about the BSON data format, how MongoDB
+uses it, and how to install the BSON library independently of the
+MongoDB Java driver. 
 
 BSON Data Format
 ----------------
diff --git a/source/fundamentals/data-formats/document-data-format-extended-json.txt b/source/fundamentals/data-formats/document-data-format-extended-json.txt
@@ -14,6 +14,9 @@ Document Data Format: Extended JSON
 Overview
 --------
 
+In this guide, you can learn how to use the Extended JSON format in the
+MongoDB Java driver. 
+
 JSON is a data format that represents the values of objects, arrays, numbers,
 strings, booleans, and nulls. The **Extended JSON** format defines a reserved
 set of keys prefixed with "``$``" to represent field type information that
diff --git a/source/fundamentals/data-formats/document-data-format-pojo.txt b/source/fundamentals/data-formats/document-data-format-pojo.txt
@@ -13,8 +13,8 @@ Document Data Format: POJOs
 Overview
 --------
 
-This guide explains how you can store and retrieve MongoDB data using plain
-old Java objects (`POJOs <https://en.wikipedia.org/wiki/Plain_old_Java_object>`__).
+In this guide, you can learn how to store and retrieve data in the
+MongoDB Java driver using plain old Java objects (`POJOs <https://en.wikipedia.org/wiki/Plain_old_Java_object>`__).
 POJOs are often used for data encapsulation, separating business logic from
 data representation.
 
diff --git a/source/fundamentals/data-formats/documents.txt b/source/fundamentals/data-formats/documents.txt
@@ -14,7 +14,10 @@ Documents
 Overview
 --------
 
-A MongoDB **document** is a data structure that contains key/value fields in
+In this guide, you can learn how to use **documents** in the
+MongoDB Java Driver.
+
+A MongoDB document is a data structure that contains key/value fields in
 binary JSON (BSON) format. You can use documents and the data they contain
 in their fields to store data as well as issue commands or queries in
 MongoDB.
diff --git a/source/fundamentals/data-formats/pojo-customization.txt b/source/fundamentals/data-formats/pojo-customization.txt
@@ -14,7 +14,7 @@ Overview
 --------
 
 In this guide, you can learn how to define custom data conversions between
-BSON and POJOs. In our guide on :doc:`POJOs </fundamentals/data-formats/document-data-format-pojo>`,
+BSON and POJOs in the MongoDB Java driver. In our guide on :doc:`POJOs </fundamentals/data-formats/document-data-format-pojo>`,
 we show how to specify a ``PojoCodecProvider`` which contains classes that
 provide instructions on how to convert data for one or more POJO classes
 and their properties.
diff --git a/source/fundamentals/databases-collections.txt b/source/fundamentals/databases-collections.txt
@@ -13,6 +13,9 @@ Databases and Collections
 Overview
 --------
 
+In this guide, you can learn how to use MongoDB databases and
+collections with the MongoDB Java driver. 
+
 MongoDB organizes data into a hierachy of the following levels:
 
 - Databases
diff --git a/source/fundamentals/enterprise-auth.txt b/source/fundamentals/enterprise-auth.txt
@@ -13,8 +13,8 @@ Enterprise Authentication Mechanisms
 Overview
 --------
 
-In this guide, we show you how to authenticate with MongoDB using each
-**authentication mechanism** available exclusively in MongoDB Enterprise
+In this guide, you can learn how to authenticate with MongoDB using each
+**authentication mechanism** available exclusively in the MongoDB Enterprise
 Edition.
 
 You can use the following mechanisms with the latest version of MongoDB
diff --git a/source/fundamentals/gridfs.txt b/source/fundamentals/gridfs.txt
@@ -13,11 +13,12 @@ GridFS
 Overview
 --------
 
-This guide shows you how to store and retrieve large files in MongoDB using
-**GridFS**. GridFS is a specification implemented by the driver that describes
-how to split files into chunks when storing them and reassemble them when
-retrieving them. The driver implementation of GridFS is an abstraction that
-manages the operations and organization of the file storage.
+In this guide, you can learn how to store and retrieve large files in
+MongoDB using **GridFS**. GridFS is a specification implemented by the
+driver that describes how to split files into chunks when storing them
+and reassemble them when retrieving them. The driver implementation of
+GridFS is an abstraction that manages the operations and organization of
+the file storage. 
 
 You should use GridFS if the size of your files exceed the BSON document
 size limit of 16MB. For more detailed information on whether GridFS is
diff --git a/source/fundamentals/indexes.txt b/source/fundamentals/indexes.txt
@@ -15,6 +15,8 @@ Indexes
 Overview
 --------
 
+In this guide, you can learn how to use **indexes** with the MongoDB Java driver.
+
 Indexes support the efficient execution of queries in MongoDB. Without indexes, MongoDB must scan *every* document in a
 collection (a **collection scan**) to find the documents that match each query. These collection scans are slow and can
 negatively affect the performance of your application. If an appropriate index exists for a query, MongoDB can use the
diff --git a/source/fundamentals/logging.txt b/source/fundamentals/logging.txt
diff --git a/source/fundamentals/monitoring.txt b/source/fundamentals/monitoring.txt
diff --git a/source/fundamentals/versioned-api.txt b/source/fundamentals/versioned-api.txt
