DOCSP-44292: improve i&h (#87)

Author: rustagir

source/issues-and-help.txt

@@ -4,54 +4,72 @@
 Issues & Help
 =============
 
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: java reactive streams, troubleshooting, feedback
+
 .. contents:: On this page
    :local:
    :backlinks: none
    :depth: 1
    :class: singlecol
 
-We are lucky to have a vibrant MongoDB {+java-rs+} community that includes users
-with varying levels of experience using the {+java-rs+} driver. We find the quickest 
-way to get support for general questions is through the `MongoDB Community Forums <https://community.mongodb.com>`_.
-
-Refer to our `support channels <https://www.mongodb.org/about/support>`_
-documentation for more information.
+We are lucky to have a vibrant MongoDB Java community that
+includes users with varying levels of experience using the
+{+driver-short+}. The quickest way to get support for general questions
+is through the :community-forum:`MongoDB Community Forums </tag/java>`.
 
 Bugs / Feature Requests
 -----------------------
 
-If you think you've found a bug or want to see a new feature in the Java
-Reactive Streams driver, please open a case in our issue management tool, Jira:
+If you have feedback about the {+driver-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 `JAVA Jira project. <https://jira.mongodb.org/browse/JAVA>`__
+#. Click :guilabel:`Create` to create a ticket. Please provide as much
+   information as possible about the issue or request in the ticket.
 
-* `Create an account and login <https://jira.mongodb.org>`_.
-* Navigate to `the JAVA project <https://jira.mongodb.org/browse/JAVA>`_.
-* Click :guilabel:`Create`. Please provide as much information as possible
-  about the issue and the steps to reproduce it.
+.. note::
 
-Bug reports in Jira for the Java project and the Core Server (SERVER) project are **public**.
+   Bug reports in the JAVA Jira project are publicly viewable.
 
-If you’ve identified a security vulnerability in a driver or any other
-MongoDB project, please report it according to the instructions found in the
-:manual:`Create a Vulnerability Report page </tutorial/create-a-vulnerability-report>`.
+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 driver. We will guide
 user contributions to ensure they meet the standards of the codebase. Please
-ensure that any pull requests include documentation and tests, and pass the
+ensure that any pull requests include documentation, tests, and pass the
 **gradle** checks.
 
-To get started, check out the source and work on a branch:
+To get started, clone the source repository and work on a branch by
+running the following commands:
 
 .. code-block:: bash
 
-   $ git clone https://github.com/mongodb/mongo-java-driver.git
-   $ cd mongo-java-driver
-   $ git checkout -b myNewFeature
+   git clone https://github.com/mongodb/mongo-java-driver.git
+   cd mongo-java-driver
+   git checkout -b myNewFeature
 
-Finally, ensure that the code passes gradle checks:
+Finally, ensure that the code passes gradle check by running the
+following command:
 
 .. code-block:: bash
 
-   $ ./gradlew check
+   ./gradlew check