Merge pull request #2714 from ccho-mongodb/DOCSP-35932-compatibility

DOCSP-35932: compatibility page

Author: Chris Cho

docs/compatibility.txt

@@ -0,0 +1,27 @@
+.. _laravel-compatibility:
+
+=============
+Compatibility
+=============
+
+.. facet::
+   :name: genre
+   :values: reference
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+Laravel Compatibility
+---------------------
+
+The following compatibility table specifies the versions of Laravel and
+{+odm-short+} that you can use together.
+
+.. include:: /includes/framework-compatibility-laravel.rst
+
+To find compatibility information for unmaintained versions of {+odm-short+},
+see `Laravel Version Compatibility <https://github.com/mongodb/laravel-mongodb/blob/3.9/README.md#installation>`__
+on GitHub.

docs/includes/framework-compatibility-laravel.rst

@@ -0,0 +1,16 @@
+.. list-table::
+   :header-rows: 1
+   :stub-columns: 1
+
+   * - {+odm-short+} Version
+     - Laravel 10.x
+     - Laravel 9.x
+
+   * - 4.1
+     - ✓
+     -
+
+   * - 4.0
+     - ✓
+     -
+

docs/index.txt

@@ -19,6 +19,7 @@ Laravel MongoDB
    /user-authentication
    /queues
    /transactions
+   /compatibility
    /upgrade
 
 Introduction
@@ -36,10 +37,6 @@ Laravel Eloquent and Query Builder syntax to work with your MongoDB data.
    maintained by MongoDB, Inc. and is compatible with Laravel 10.x and
    later.
 
-   To find versions of the package compatible with older versions of Laravel,
-   see `Laravel Version Compatibility <https://github.com/mongodb/laravel-mongodb/blob/3.9/README.md#installation>`__
-   on GitHub.
-
 Getting Started
 ---------------
 
@@ -58,6 +55,12 @@ see the following content:
 - :ref:`laravel-queues`
 - :ref:`laravel-transactions`
 
+Compatibility
+-------------
+
+To learn more about which versions of the {+odm-long+} and Laravel are
+compatible, see the :ref:`laravel-compatibility` section.
+
 Upgrade Versions
 ----------------