DOCSP-31150: Remove legacy projects from PHP libraries (#889) (#892)

* PHPORM-26: Remove legacy projects (#892)

Author: Chris Cho

source/php-libraries.txt

@@ -4,90 +4,91 @@
 PHP Libraries, Frameworks, and Tools
 ====================================
 
-.. default-domain:: mongodb
-
 .. contents:: On this page
    :local:
    :backlinks: none
    :depth: 2
    :class: singlecol
 
-Stand-alone Libraries
----------------------
+Standalone Libraries
+--------------------
+
+- `Doctrine MongoDB ODM <https://github.com/doctrine/mongodb-odm>`__ (Object
+  Document Mapper) is a library that provides object-mapping functionality for
+  MongoDB.  You can use the standalone library or use one of the following
+  framework integrations:
+
+  - `Symfony <https://github.com/doctrine/DoctrineMongoDBBundle>`__
+  - `Laminas <https://github.com/doctrine/DoctrineMongoODMModule>`__ (formerly Zend Framework)
 
-- `Doctrine MongoDB ODM <https://github.com/doctrine/mongodb-odm>`_ is a library
-  that provides object mapping functionality for MongoDB. Integrations with
-  `Symfony <https://github.com/doctrine/DoctrineMongoDBBundle>`_ and
-  `Laminas <https://github.com/doctrine/DoctrineMongoODMModule>`_ (formerly Zend
-  Framework) are also available.
+- `Mongo PHP Adapter <https://github.com/alcaeus/mongo-php-adapter>`__ is a
+  library designed to act as an adapter between applications that rely
+  on the legacy ``mongo`` extension and the new ``mongodb`` extension. It
+  offers the API of the legacy driver for the new driver and library.
 
-- `Mongo PHP Adapter <https://github.com/alcaeus/mongo-php-adapter>`_ is a
-  userland library designed to act as an adapter between applications relying on
-  the legacy ``mongo`` extension and the new ``mongodb`` extension. It provides
-  the API of the legacy driver on top of the new driver and library, which
-  allows for compatibility with PHP 7.
+- `Mongolid <https://github.com/leroy-merlin-br/mongolid>`__ is a performant
+  ODM for PHP and MongoDB. It implements both ActiveRecord and DataMapper
+  design patterns and supports embedded and referenced documents. You can use
+  this standalone library or use the `Laravel <https://github.com/leroy-merlin-br/mongolid-laravel>`__
+  integration.
 
-- `Mongolid <https://github.com/leroy-merlin-br/mongolid>`_: A fast ODM for PHP and
-  MongoDB, which implements both ActiveRecord and DataMapper design patterns and
-  supports embedded and referenced documents. An integration with
-  `Laravel <https://github.com/leroy-merlin-br/mongolid-laravel>`__ is also available.
+- `Xenus <https://github.com/abellion/xenus>`__ is a MongoDB ODM
+  that supports events, relationships, embedded documents, and more. You can
+  use this standalone library or use the `Laravel <https://github.com/abellion/xenus-laravel>`__
+  integration, which adds support for failed jobs, migrations, and events.
 
-- `Xenus <https://github.com/abellion/xenus>`_ is an elegant MongoDB ODM
-  that supports events, relationships, embedded documents, and more. An
-  integration with `Laravel <https://github.com/abellion/xenus-laravel>`__ is
-  also available, which adds support for failed jobs, migrations, and events.
 
 Framework Integrations
 ----------------------
 
 - Drupal
 
-  - `MongoDB integration for Drupal <https://www.drupal.org/project/mongodb>`_.
-    This is a collection of several modules which allow sites to store different
-    types of Drupal data in MongoDB. Support for the ``mongodb`` extension
-    exists for Drupal 8+.
+  - `MongoDB integration for Drupal <https://www.drupal.org/project/mongodb>`__.
+    This is a collection of several modules that allow sites to store different
+    types of Drupal data in MongoDB. The ``mongodb`` extension supports
+    Drupal 8 and later.
 
 - Laravel
 
-  - `Laravel MongoDB <https://github.com/jenssegers/laravel-mongodb>`_: An
-    Eloquent model and Query builder with support for MongoDB, using the
-    original Laravel API. This library extends the original Laravel classes, so
-    it uses exactly the same methods.
+  - `Laravel MongoDB <https://github.com/jenssegers/laravel-mongodb>`__ is an
+    Eloquent model and Query builder that supports MongoDB by using the
+    original Laravel API. This library extends the original Laravel classes
+    and therefore uses the same methods.
 
 - Symfony
 
-  - The components `Lock <https://symfony.com/doc/current/components/lock.html#mongodbstore>`_ and
-    `Session <https://symfony.com/doc/current/session.html#store-sessions-in-a-nosql-database-mongodb>`_
-    can be configured to use MongoDB.
+  - You can configure the `Lock <https://symfony.com/doc/current/components/lock.html#mongodbstore>`__
+    and the `Session <https://symfony.com/doc/current/session.html#store-sessions-in-a-nosql-database-mongodb>`__
+    to use MongoDB as a data store.
 
-  - `MongoDB Bundle <https://github.com/facile-it/mongodb-bundle>`_: A
-    simple bundle service integration for the official `PHP library
-    <https://github.com/mongodb/mongo-php-library>`_. Allows you to configure
-    connections to different databases or clusters and includes a convenient
-    query profiler.
+  - `MongoDB Bundle <https://github.com/facile-it/mongodb-bundle>`__ is a
+    bundle service integration for the official `PHP library <https://github.com/mongodb/mongo-php-library>`__.
+    You can use it to configure connections to different databases or clusters.
+    This integration includes a query profiler.
 
-  - `DoctrineMongoDBBundle Symfony <https://github.com/doctrine/DoctrineMongoDBBundle>`_
-    This bundle integrates the Doctrine Object Document Mapper (ODM) into Symfony so
-    that you can persist and retrieve objects to and from MongoDB.
+  - `DoctrineMongoDBBundle Symfony <https://github.com/doctrine/DoctrineMongoDBBundle>`__
+    This bundle integrates the Doctrine MongoDB ODM into Symfony so that you
+    can store and retrieve objects from MongoDB.
 
 - Yii2
 
-  - `MongoDB Extension for Yii 2
-    <https://www.yiiframework.com/extension/yiisoft/yii2-mongodb>`_ provides
-    MongoDB integration for Yii framework 2.0.
+  - `MongoDB Extension for Yii 2 <https://www.yiiframework.com/extension/yiisoft/yii2-mongodb>`__
+    is a MongoDB integration for the Yii 2 framework.
 
-Miscellaneous Projects
-----------------------
+Tools and Projects
+------------------
 
-- `PHP Cache <https://github.com/php-cache/mongodb-adapter/>` is a PSR-6 cache
-  implementation using MongoDB. It is a part of the PHP Cache organisation.
+- `PHP Cache <https://github.com/php-cache/mongodb-adapter/>`__ is a PSR-6 cache
+  implementation that uses MongoDB as a cache pool. This project is part of
+  the PHP Cache organization.
 
-- `PHPfastcache <https://github.com/PHPSocialNetwork/phpfastcache>`_ provides a simple,
+- `PHPfastcache <https://github.com/PHPSocialNetwork/phpfastcache>`__ is a
   high-performance backend cache system for MongoDB.
 
-- `Enqueue <https://github.com/php-enqueue/mongodb>` is production ready,
-   battle-tested messaging solution for PHP. It provides a common way for programs
-   to create, send, read messages.
+- `Enqueue <https://github.com/php-enqueue/mongodb>`__ is a production-ready
+  messaging solution that uses MongoDB as the message queue broker. It provides
+  a common way for programs to create, send, and read messages.
+
+- `XHGui <https://github.com/perftools/xhgui>`__ is a web interface for the
+  XHProf profiler, which stores profiling data in MongoDB.
 
-- `XHGui <https://github.com/perftools/xhgui>`_, a web interface for the XHProf profiler
-  that stores profiling data in MongoDB.