DOCSP-35931: Issues and Help page (#2744)

Author: norareidy

docs/compatibility.txt

@@ -23,5 +23,5 @@ The following compatibility table specifies the versions of Laravel and
 .. 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>`__
+see `Laravel Version Compatibility <{+mongodb-laravel-gh+}/blob/3.9/README.md#installation>`__
 on GitHub.

docs/index.txt

@@ -13,14 +13,14 @@ Laravel MongoDB
    :titlesonly:
    :maxdepth: 1
 
-   /install
    /quick-start
    /retrieve
    /eloquent-models
    /query-builder
    /user-authentication
    /queues
    /transactions
+   /issues-and-help
    /compatibility
    /upgrade
 
@@ -59,6 +59,12 @@ see the following content:
 - :ref:`laravel-queues`
 - :ref:`laravel-transactions`
 
+Issues & Help
+-------------
+
+Learn how to report bugs, contribute to the library, and find
+more resources in the :ref:`laravel-issues-and-help` section.
+
 Compatibility
 -------------
 
@@ -71,57 +77,4 @@ Upgrade Versions
 Learn what changes you might need to make to your application to upgrade
 versions in the :ref:`laravel-upgrading` section.
 
-Reporting Issues
-----------------
-
-We are lucky to have a vibrant PHP community that includes users of varying
-experience with MongoDB PHP Library and {+odm-short+}. To get support for
-general questions, search or post in the
-:community-forum:`MongoDB Community Forums <>`.
-
-To learn more about MongoDB support options, see the
-`Technical Support <https://www.mongodb.org/about/support>`__ page.
-
-
-Bugs / Feature Requests
------------------------
-
-If you've found a bug or want to see a new feature in {+odm-short+},
-please report it in the GitHub issues section of the
-`mongodb/laravel-mongodb <https://github.com/mongodb/laravel-mongodb>`__
-repository.
-
-If you want to contribute code, see the following section for instructions on
-submitting pull requests.
-
-To report a bug or request a new feature, perform the following steps:
-
-1. Visit the `GitHub issues <https://github.com/mongodb/laravel-mongodb/issues>`__
-   section and search for any similar issues or bugs.
-#. If you find a matching issue, you can reply to the thread to report that
-   you have a similar issue or request.
-#. If you cannot find a matching issue, click :guilabel:`New issue` and select
-   the appropriate issue type.
-#. If you selected "Bug report" or "Feature request", please provide as much
-   information as possible about the issue. Click :guilabel:`Submit new issue`
-   to complete your submission.
-
-If you've identified a security vulnerability in any official MongoDB
-product, please report it according to the instructions found in the
-:manual:`Create a Vulnerability Report page </tutorial/create-a-vulnerability-report>`.
-
-For general questions and support requests, please use one of MongoDB's
-:manual:`Technical Support </support/>` channels.
-
-Pull Requests
--------------
-
-We are happy to accept contributions to help improve the {+odm-short+}.
-
-We track current development in `PHPORM <https://jira.mongodb.org/projects/PHPORM/summary>`__
-MongoDB JIRA project.
-
-To learn more about contributing to this project, see the
-`CONTRIBUTING.md <https://github.com/mongodb/laravel-mongodb/blob/4.1/CONTRIBUTING.md>`__
-guide on GitHub.
 

docs/issues-and-help.txt

@@ -0,0 +1,56 @@
+.. _laravel-issues-and-help:
+
+=============
+Issues & Help
+=============
+
+We are lucky to have a vibrant PHP community that includes users of varying
+experience with MongoDB PHP Library and {+odm-short+}. To get support for
+general questions, search or post in the
+:community-forum:`MongoDB PHP Community Forums </tag/php>`.
+
+To learn more about MongoDB support options, see the
+`Technical Support <https://www.mongodb.org/about/support>`__ page.
+
+Bugs / Feature Requests
+-----------------------
+
+If you find a bug or want to see a new feature in {+odm-short+},
+please report it as a GitHub issue in the `mongodb/laravel-mongodb
+<{+mongodb-laravel-gh+}>`__ repository.
+
+If you want to contribute code, see the :ref:`laravel-pull-requests` section
+for instructions on submitting pull requests.
+
+To report a bug or request a new feature, perform the following steps:
+
+1. Review the `GitHub issues list <{+mongodb-laravel-gh+}/issues>`__
+   in the source repository and search for any existing issues that address your concern.
+#. If you find a matching issue, you can reply to the thread to report that
+   you have a similar issue or request.
+#. If you cannot find a matching issue, click :guilabel:`New issue` and select
+   the appropriate issue type.
+#. If you select "Bug report" or "Feature request" as the issue type, please provide as
+   much information as possible about the issue. Click :guilabel:`Submit new issue`
+   to complete your submission.
+
+If you've identified a security vulnerability in any official MongoDB
+product, please report it according to the instructions found in the
+:manual:`Create a Vulnerability Report page </tutorial/create-a-vulnerability-report>`.
+
+For general questions and support requests, please use one of MongoDB's
+:manual:`Technical Support </support/>` channels.
+
+.. _laravel-pull-requests:
+
+Pull Requests
+-------------
+
+We are happy to accept contributions to help improve {+odm-short+}.
+
+We track current development in `PHPORM <https://jira.mongodb.org/projects/PHPORM/summary>`__
+MongoDB JIRA project.
+
+To learn more about contributing to this project, see the
+`CONTRIBUTING.md <{+mongodb-laravel-gh+}/blob/{+package-version+}/CONTRIBUTING.md>`__
+guide on GitHub.