issues and help, edits

Author: norareidy

source/crud.txt

@@ -25,7 +25,7 @@ CRUD Operations
    Insert Documents </crud/insert>
    Query Documents </crud/query>
    Update Documents </crud/update>
-   Delete Documents </crud/replace>
+   Replace Documents </crud/replace>
    Delete Documents </crud/delete>
    Bulk Write Operations </crud/bulk-write>
    Transactions </crud/transaction>

source/crud/bulk-write.txt

@@ -68,7 +68,7 @@ specify the write operations:
 .. tip::
 
     For more information about delete, insert, replace, and update
-    operations, see the :ref:`Write operation guides <php-write>`.
+    operations, see the :ref:`CRUD <php-crud-operations>` section.
 
 When you call the ``bulkWrite()`` method, the library automatically runs the
 write operations in the order they're specified in the array. To learn how to

source/crud/insert.txt

@@ -158,9 +158,6 @@ insert operation bypasses document-level validation:
 Additional Information
 ----------------------
 
-To view runnable code examples of inserting documents with the {+php-library+}, see
-:ref:`php-write`.
-
 API Documentation
 ~~~~~~~~~~~~~~~~~
 

source/crud/query/retrieve.txt

@@ -240,9 +240,6 @@ Additional Information
 
 To learn more about query filters, see the :ref:`php-specify-query` guide.
 
-To view code examples of retrieving documents with the {+php-library+},
-see :ref:`php-read`.
-
 API Documentation
 ~~~~~~~~~~~~~~~~~
 

source/get-started.txt

@@ -344,5 +344,5 @@ and retrieves a document that matches a query.
 
 Learn more about the {+php-library+} from the following resources:
 
-- Learn how to perform read operations in the :ref:`<php-read>` section.
-- Learn how to perform write operations in the :ref:`<php-write>` section.
+- Learn how to configure your MongoDB connection in the :ref:`<php-connect>` section.
+- Learn how to perform read and write operations in the :ref:`<php-crud-operations>` section.

source/includes/extracts-bucket-option.yaml

@@ -1,6 +1,6 @@
 ref: bucket-option-codec
 content: |
-  The :doc:`codec </data-formats/codecs>` to use for encoding or decoding documents.
+  The :ref:`php-codecs` to use for encoding or decoding documents.
   This option is mutually exclusive with the ``typeMap`` option.
 
   Defaults to the bucket's codec. Inheritance for a default ``codec`` option

source/includes/extracts-collection-option.yaml

@@ -1,6 +1,6 @@
 ref: collection-option-codec
 content: |
-  The :doc:`codec </data-formats/codecs>` to use for encoding or decoding documents.
+  The :ref:`php-codecs` to use for encoding or decoding documents.
   This option is mutually exclusive with the ``typeMap`` option.
 
   Defaults to the collection's codec. Inheritance for a default ``codec`` option

source/includes/extracts-common-option.yaml

@@ -1,6 +1,6 @@
 ref: common-option-codec
 content: |
-  The :doc:`codec </data-formats/codecs>` to use for encoding or decoding documents.
+  The :ref:`php-codecs` to use for encoding or decoding documents.
   This option is mutually exclusive with the ``typeMap`` option.
 ---
 ref: common-option-collation

source/index.txt

@@ -28,6 +28,7 @@ MongoDB PHP Library
    Reference </references>
    FAQ </faq>
    API Documentation </reference>
+   Issues & Help </issues-and-help>
 
 Overview
 --------
@@ -118,3 +119,9 @@ FAQ
 
 See answers to commonly asked questions about the {+library-short+} in the
 the :ref:`php-faq` section.
+
+Issues & Help
+-------------
+
+Learn how to report bugs, contribute to the library, and find help in the
+:ref:`Issues & Help <php-issues-and-help>` section.

source/issues-and-help.txt

@@ -0,0 +1,80 @@
+.. _php-issues-and-help:
+
+=============
+Issues & Help
+=============
+
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: php, troubleshooting, feedback
+   :description: Find support for the {+library-short+, report bugs or feature requests, and learn how to contribute.
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+We are lucky to have a vibrant MongoDB PHP community that includes users
+with varying levels of experience using the {+library-short+}. The
+quickest way to get support for general questions is through the
+:community-forum:`MongoDB Community Forums </tag/php>`.
+
+Bugs / Feature Requests
+-----------------------
+
+If you have feedback about the {+library-short+}, visit the `MongoDB
+Feedback Engine <https://feedback.mongodb.com/>`__ and select
+:guilabel:`Drivers` from the list of products on the right side of
+your screen. You can propose improvements, report issues, and provide
+other types of feedback by using this site.
+
+You can also open a case in Jira, our issue management tool, to identify
+bugs or propose improvements. The following steps describe how to create
+a Jira issue:
+
+1. Visit the `MongoDB Jira issue tracker <https://jira.mongodb.org/>`__ and click the 
+   `signup link. <https://account.mongodb.com/account/register>`__
+   Create an account, and then log in to Jira.
+#. Navigate to the `PHPLIB Jira project. <https://jira.mongodb.org/browse/PHPLIB>`__
+#. Click :guilabel:`Create` to create a ticket. Please provide as much
+   information as possible about the issue or request in the ticket.
+
+.. note::
+
+   Bug reports in the PHP Jira project are publicly viewable.
+
+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>`
+
+Pull Requests
+-------------
+
+We are happy to accept contributions to help improve the {+library-short+}. We guide
+user contributions to ensure they meet the standards of the codebase. Ensure
+that any pull requests include documentation, tests, and pass the
+static analysis checks.
+
+To contribute to the library, check out the source and work on a branch:
+
+.. code-block:: bash
+
+   git clone https://github.com/mongodb/mongo-php-library.git
+   cd mongo-php-library
+   composer update
+   git checkout -b myNewFeature
+
+Then, run the library's test suite by using the following command:
+
+.. code-block:: bash
+
+   composer run test
+
+To learn more about the requirements for pull requests, see
+:github:`Contributing to the PHP Library for MongoDB
+</mongodb/mongo-php-library/blob/{+source-gh-branch+}/CONTRIBUTING.md>`
+on GitHub.

source/reference/method/MongoDBClient-getCollection.txt

@@ -47,7 +47,7 @@ Parameters
 
      * - codec
        - MongoDB\\Codec\\DocumentCodec
-       - The default :doc:`codec </data-formats/codecs>` to use for collection
+       - The default :ref:`php-codecs` to use for collection
          operations.
 
          .. versionadded:: 1.17

source/reference/method/MongoDBClient-selectCollection.txt

@@ -50,7 +50,7 @@ Parameters
 
      * - codec
        - MongoDB\\Codec\\DocumentCodec
-       - The default :doc:`codec </data-formats/codecs>` to use for collection
+       - The default :ref:`php-codecs` to use for collection
          operations.
 
          .. versionadded:: 1.17

source/reference/method/MongoDBCollection-bulkWrite.txt

@@ -148,7 +148,6 @@ See Also
 --------
 
 - :ref:`php-bulk-write`
-- :ref:`php-write`
 - :phpmethod:`MongoDB\Collection::deleteMany()`
 - :phpmethod:`MongoDB\Collection::deleteOne()`
 - :phpmethod:`MongoDB\Collection::insertMany()`

source/reference/method/MongoDBCollection__construct.txt

@@ -60,7 +60,7 @@ Definition
 
      * - codec
        - MongoDB\\Codec\\DocumentCodec
-       - The default :doc:`codec </data-formats/codecs>` to use for collection
+       - The default :ref:`php-codecs` to use for collection
          operations.
 
          .. versionadded:: 1.17

source/reference/method/MongoDBDatabase-getCollection.txt

@@ -43,7 +43,7 @@ Parameters
 
      * - codec
        - MongoDB\\Codec\\DocumentCodec
-       - The default :doc:`codec </data-formats/codecs>` to use for collection
+       - The default :ref:`php-codecs` to use for collection
          operations.
 
          .. versionadded:: 1.17

source/reference/method/MongoDBDatabase-selectCollection.txt

@@ -43,7 +43,7 @@ Parameters
 
      * - codec
        - MongoDB\\Codec\\DocumentCodec
-       - The default :doc:`codec </data-formats/codecs>` to use for collection
+       - The default :ref:`php-codecs` to use for collection
          operations.
 
          .. versionadded:: 1.17

source/reference/method/MongoDBDatabase-selectGridFSBucket.txt

@@ -48,7 +48,7 @@ Parameters
 
      * - codec
        - MongoDB\\Codec\\DocumentCodec
-       - The default :doc:`codec </data-formats/codecs>` to use for bucket methods
+       - The default :ref:`php-codecs` to use for bucket methods
          that return a file document (e.g. :phpmethod:`MongoDB\GridFS\Bucket::find()`).
 
          .. versionadded:: 1.17

source/reference/method/MongoDBGridFSBucket__construct.txt

@@ -56,7 +56,7 @@ Parameters
 
      * - codec
        - MongoDB\\Codec\\DocumentCodec
-       - The default :doc:`codec </data-formats/codecs>` to use for bucket methods
+       - The default :ref:`php-codecs` to use for bucket methods
          that return a file document (e.g. :phpmethod:`MongoDB\GridFS\Bucket::find()`).
 
          .. versionadded:: 1.17

source/security.txt

@@ -24,6 +24,7 @@ Secure Your Data
 
    Authentication </security/authentication>
    Encryption </security/in-use-encryption>
+   TLS </security/tls>
 
 Overview
 --------