DOCSP-19091 landing page update (#168)

* made landing page task oriented

Author: kyuan-mongodb

source/fundamentals.txt

@@ -25,20 +25,4 @@ Fundamentals
    /fundamentals/csfle
    /fundamentals/time-series
 
-The Fundamentals section explains how to perform the following tasks
-using the Java driver:
-
-- :doc:`Connect to MongoDB </fundamentals/connection>`
-- :doc:`Use the Versioned API </fundamentals/versioned-api>`
-- :doc:`Authenticate with MongoDB </fundamentals/auth>`
-- :doc:`Convert between MongoDB Data Formats and Java Objects </fundamentals/data-formats>`
-- :doc:`Read from and Write to MongoDB </fundamentals/crud>`
-- :doc:`Simplify your Code with Builders </fundamentals/builders>`
-- :doc:`Transform your Data </fundamentals/aggregation>`
-- :doc:`Create Indexes to Speed Up Queries </fundamentals/indexes>`
-- :doc:`Sort Using Collations </fundamentals/collations>`
-- :doc:`Log Events in the Driver </fundamentals/logging>`
-- :doc:`Monitor Driver Events </fundamentals/monitoring>`
-- :doc:`Store and Retrieve Large Files in MongoDB </fundamentals/gridfs>`
-- :doc:`Encrypt Fields in a Document </fundamentals/csfle>`
-- :doc:`Use a Time Series Collection </fundamentals/time-series>`
+.. include:: /includes/fundamentals-sections.rst

source/includes/fundamentals-sections.rst

@@ -0,0 +1,17 @@
+Learn how to perform the following tasks using the Java driver in the
+Fundamentals section:
+
+- :doc:`Connect to MongoDB </fundamentals/connection>`
+- :doc:`Use the Versioned API </fundamentals/versioned-api>`
+- :doc:`Authenticate with MongoDB </fundamentals/auth>`
+- :doc:`Convert between MongoDB Data Formats and Java Objects </fundamentals/data-formats>`
+- :doc:`Read from and Write to MongoDB </fundamentals/crud>`
+- :doc:`Simplify your Code with Builders </fundamentals/builders>`
+- :doc:`Transform your Data </fundamentals/aggregation>`
+- :doc:`Create Indexes to Speed Up Queries </fundamentals/indexes>`
+- :doc:`Sort Using Collations </fundamentals/collations>`
+- :doc:`Log Events in the Driver </fundamentals/logging>`
+- :doc:`Monitor Driver Events </fundamentals/monitoring>`
+- :doc:`Store and Retrieve Large Files in MongoDB </fundamentals/gridfs>`
+- :doc:`Encrypt Fields in a Document </fundamentals/csfle>`
+- :doc:`Use a Time Series Collection </fundamentals/time-series>`

source/index.txt

@@ -16,62 +16,47 @@ MongoDB Java Driver
    /issues-and-help
    /compatibility
    /whats-new
+   Release Notes <https://github.com/mongodb/mongo-java-driver/releases>
+   View the Source <https://github.com/mongodb/mongo-java-driver>
 
 Introduction
 ------------
 
-Welcome to the MongoDB Java driver documentation. This documentation is
-for the *synchronous* driver. If you are working with asynchronous stream
-processing and reactive streams, we recommend the `Reactive Streams Driver
-<https://mongodb.github.io/mongo-java-driver-reactivestreams/>`__.
+Welcome to the MongoDB Java driver documentation. 
+
+This documentation is for the *synchronous* driver. If you are working
+with asynchronous stream processing and reactive streams, we recommend
+the `Reactive Streams Driver <https://mongodb.github.io/mongo-java-driver-reactivestreams/>`__.
+
+Connect your Java applications to MongoDB and work with your data
+using the official Java driver. On this page, you can find descriptions of
+each section of the driver documentation and how to learn more about the Java driver.
 
-The official MongoDB Java driver lets you connect your Java applications
-to MongoDB and work with your data. On this page, you can find descriptions of
-each section of the driver documentation and where to go to learn more
-about the Java driver.
 
 Quick Start
 -----------
 
-This :doc:`Quick Start </quick-start>` section is where you can
-establish a connection to MongoDB Atlas and begin working with data.
+Learn how to establish a connection to MongoDB Atlas and begin
+working with data in the :doc:`Quick Start </quick-start>` section.
 
 Usage Examples
 --------------
 
-The :doc:`Usage Examples </usage-examples>` section is where you can
-find runnable code snippets and high-level explanations for common
-methods.
+For fully runnable code snippets and explanations for common
+methods, see the :doc:`Usage Examples </usage-examples>` section.
 
 Fundamentals
 ------------
 
-The Fundamentals section explains how to perform the following tasks
-using the Java driver:
-
-- :doc:`Connect to MongoDB </fundamentals/connection>`
-- :doc:`Use the Versioned API </fundamentals/versioned-api>`
-- :doc:`Authenticate with MongoDB </fundamentals/auth>`
-- :doc:`Convert between MongoDB Data Formats and Java Objects </fundamentals/data-formats>`
-- :doc:`Read from and Write to MongoDB </fundamentals/crud>`
-- :doc:`Simplify your Code with Builders </fundamentals/builders>`
-- :doc:`Transform your Data </fundamentals/aggregation>`
-- :doc:`Create Indexes to Speed Up Queries </fundamentals/indexes>`
-- :doc:`Sort Using Collations </fundamentals/collations>`
-- :doc:`Log Events in the Driver </fundamentals/logging>`
-- :doc:`Monitor Driver Events </fundamentals/monitoring>`
-- :doc:`Store and Retrieve Large Files in MongoDB </fundamentals/gridfs>`
-- :doc:`Encrypt Fields in a Document </fundamentals/csfle>`
-- :doc:`Use a Time Series Collection </fundamentals/time-series>`
+.. include:: /includes/fundamentals-sections.rst
 
 API Documentation
 -----------------
 
-The MongoDB Java driver API documentation contains detailed information
-about classes and methods in the MongoDB Java driver. The driver
-contains of the following libraries organized by functionality. See the
-following table for descriptions of each library and links to the API
-documentation.
+The MongoDB Java driver API documentation contains several libraries
+organized by functionality. For detailed information about classes and
+methods in each library, see the following table for their descriptions
+and links to the API documentation.
 
 .. list-table::
    :header-rows: 1
@@ -96,27 +81,29 @@ documentation.
 FAQ
 ---
 
-The :doc:`Frequently Asked Questions (FAQ) </faq>` section provides answers
-to commonly asked questions about the MongoDB Java Driver.
+For answers to commonly asked questions about the MongoDB
+Java Driver, see the :doc:`Frequently Asked Questions (FAQ) </faq>`
+section.
 
 Issues & Help
 -------------
 
-The :doc:`Issues & Help </issues-and-help>` section explains how to report
-bugs, contribute to the driver, and find additional resources for asking
-questions and receiving help.
+Learn how to report bugs, contribute to the driver, and find
+additional resources for asking questions and receiving help in the
+:doc:`Issues & Help </issues-and-help>` section.
 
 Compatibility
 -------------
 
-The :doc:`Compatibility </compatibility>` section shows compatibility charts
-with JVM and MongoDB server versions.
+For the compatibility charts that show the recommended Java
+Driver version for each MongoDB Server version, see the
+:doc:`Compatibility </compatibility>` section.
 
 What's New
 ----------
 
-The :doc:`What's New </whats-new>` section lists new features and
-changes in each version.
+For a list of new features and changes in each version, see the
+:doc:`What's New </whats-new>` section.
 
 Learn
 ------
@@ -151,6 +138,5 @@ Take the free online course taught by MongoDB instructors
        .. figure:: /includes/figures/M220J_hero.jpg
           :alt: M220J Course Hero
 
-     - `M220J: MongoDB for Java Developers <https://university.mongodb.com/courses/M220J/about>`_
-
-       Learn the essentials of Java application development with MongoDB.
+     - | `M220J: MongoDB for Java Developers <https://university.mongodb.com/courses/M220J/about>`_ 
+       | Learn the essentials of Java application development with MongoDB.