DOCSP-41950: Landing page

Author: norareidy

source/faq.txt

@@ -1,3 +1,5 @@
+.. _php-faq:
+
 ==========================
 Frequently Asked Questions
 ==========================

source/index.txt

@@ -18,68 +18,97 @@ MongoDB PHP Library
    /indexes
    /monitoring
    /security
-   /tutorial
-   /upgrade
-   /reference
-   FAQ </faq>
    /compatibility
    /whats-new
+   FAQ </faq>
+   /reference
+
+Overview
+--------
+
+Welcome to the documentation site for the official {+php-library+}.
 
-The |php-library| provides a high-level abstraction around the lower-level
+The {+driver-short+} provides a high-level abstraction around the lower-level
 :php:`mongodb extension <mongodb>`.
 
-The ``mongodb`` extension provides a limited API to connect to the database and
-execute generic commands, queries, and write operations. In contrast, the
-|php-library| provides a full-featured API and models client, database, and
-collection objects. Each of those classes provide various helper methods for
-performing operations in context. For example, :phpclass:`MongoDB\Collection`
-implements methods for executing CRUD operations and managing indexes on the
-collection, among other things.
+The ``mongodb`` extension provides a limited API to connect to a MongoDB
+database and execute generic commands, queries, and write operations. In
+contrast, the {+driver-short+} provides a full-featured API and models client,
+database, and collection objects. If you are developing a PHP application with
+MongoDB, consider using the {+driver-short+} instead of the extension alone.
+
+Get Started
+-----------
+
+Learn how to install the library and extension, establish a connection to MongoDB,
+and begin working with data in the :ref:`php-get-started` tutorial.
+
+Connect to MongoDB
+------------------
+
+Learn how to create and configure a connection to a MongoDB deployment
+in the :ref:`php-connect` section.
+
+Databases and Collections
+-------------------------
+
+Learn how to use the {+driver-short+} to work with MongoDB databases and collections
+in the :ref:`php-databases-collections` section.
 
-If you are developing a PHP application with MongoDB, you should consider using
-the |php-library| instead of the extension alone.
+Read Data from MongoDB
+----------------------
 
-New to the PHP Library?
------------------------
+Learn how you can retrieve data from MongoDB in the :ref:`php-read` section.
 
-If you have some experience with MongoDB but are new to the PHP library, the
-following pages should help you get started:
+Write Data to MongoDB
+---------------------
 
-- :ref:`php-download-and-install`
+Learn how you can write data to MongoDB in the :ref:`php-write` section.
 
-- :doc:`/tutorial/connecting`
+Transform Your Data with Aggregation
+------------------------------------
 
-- :doc:`/tutorial/crud`
+Learn how to use the {+driver-short+} to perform aggregation operations in the
+:ref:`php-aggregation` section.
 
-- :doc:`/tutorial/commands`
+Optimize Queries with Indexes
+-----------------------------
 
-- :doc:`/tutorial/gridfs`
+Learn how to work with common types of indexes in the :ref:`php-indexes`
+section.
 
-- :doc:`/tutorial/modeling-bson-data`
+Monitoring
+----------
 
-- :doc:`/reference/bson`
+Learn how to monitor change events in the :ref:`php-monitoring`
+section.
 
-Code examples can be found in the ``examples`` directory in the source code.
+Secure Your Data
+----------------
 
-If you have previously worked with the legacy ``mongo`` extension, it will be
-helpful to review the :doc:`/upgrade` for a summary of API changes between the
-old driver and this library.
+Learn about ways you can authenticate your application and encrypt your data in
+the :ref:`php-security` section.
 
-You can view changes introduced in each version release of the
-{+php-library+} in the :ref:`php-lib-whats-new` section.
+Compatibility
+-------------
 
-New to MongoDB?
----------------
+See compatibility tables showing the recommended {+driver-short+} version to use for
+specific PHP and {+mdb-server+} versions in the :ref:`php-compatibility` section.
 
-If you are a new MongoDB user, the following links should help you become more
-familiar with MongoDB and introduce some of the concepts and terms you will
-encounter in the library documentation:
+What's New
+----------
 
-- :manual:`Introduction to MongoDB </introduction>`
+Learn about new features and changes in each version in the :ref:`<php-lib-whats-new>`
+section.
 
-- :manual:`Databases and Collections </core/databases-and-collections>`
+.. TODO:
+ Upgrade {+driver-short+} Versions
+ ---------------------------------
+ Learn what changes you might need to make to your application to upgrade driver versions
+ in the :ref:`php-upgrade` section.
 
-- :manual:`Documents </core/document>` and
-  :manual:`BSON Types </reference/bson-types>`
+FAQ
+---
 
-- :manual:`MongoDB CRUD Operations </crud>`
+See answers to commonly asked questions about the {+driver-short+} in the
+the :ref:`php-faq` section.