DOCSP-44968-submit-feedback (#7)

* DOCSP-44968-submit-feedback

* *

* prereq

* *

* metadata tags

* *

* wording

Author: ajhuh-mdb

snooty.toml

@@ -5,7 +5,10 @@ intersphinx = [ "https://www.mongodb.com/docs/manual/objects.inv",
                 "https://www.mongodb.com/docs/atlas/objects.inv"
               ]
 
-toc_landing_pages = ["/connect"]
+toc_landing_pages = [
+    "/connect", 
+    "/submit-feedback"
+]
 
 [constants]
 intellij-full = "MongoDB for IntelliJ Plugin"

source/logs.txt

@@ -0,0 +1,49 @@
+.. _intellij-logs:
+
+======================
+Retrieve IntelliJ Logs
+======================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+This page describes how to retrieve log files from IntelliJ IDEA.
+
+About This Task 
+---------------
+
+Log files help the MongoDB development team diagnose bugs in the 
+{+intellij-short+}. When you retrieve log files, IntelliJ generates a zip with 
+the following contents:
+
+- General information about the IDE installation such as version, host OS, host 
+  CPU, available memory, other plugins that might affect current functionality.
+- Thread dumps of the current state of IntelliJ. 
+- Internal state of the UI.
+- OpenTelemetry metrics from IntelliJ.
+- Logs of all the plugins, including the {+intellij-full+}.
+
+Steps
+-----
+
+.. procedure:: 
+   :style: normal
+
+   .. step:: In the IntelliJ top menu bar, click Help.
+
+   .. step:: In the Help menu, click Collect Logs and Diagnostic Data. 
+     
+      A pop-up warning appears, mentioning that the collected information might 
+      contain sensitive data. 
+      
+   .. step:: Click Show in Finder.
+
+Learn More 
+----------
+
+- :ref:`intellij-submit-feedback`

source/submit-feedback.txt

@@ -6,10 +6,79 @@ Submit Feedback
 
 .. default-domain:: mongodb
 
+.. facet:: 
+   :name: genre
+   :values: tutorial 
+
+.. meta:: 
+   :description: Submit feedback on the MongoDB for IntelliJ Plugin JIRA project.
+
 .. contents:: On this page
    :local:
    :backlinks: none
    :depth: 1
    :class: singlecol
 
-Content on this page will be addressed in DOCSP-44968.
+To report a bugs, request a feature, or submit general feedback, follow the 
+procedures on this page to open a ticket in the 
+`MongoDB for IntelliJ Plugin JIRA project <https://jira.mongodb.org/projects/INTELLIJ/issues/>`__.
+
+Before You Begin 
+----------------
+
+To submit feedback and vote on issues, you must be logged in to a JIRA account.
+
+Steps 
+-----
+
+.. procedure:: 
+   :style: normal 
+
+   .. step:: Open the ticket creation dialog.
+
+      To open a new ticket, click :guilabel:`Create` in the JIRA top navigation 
+      bar.
+
+   .. step:: Specify the issue type.
+
+      Open the :guilabel:`Issue Type` drop-down menu and select the appropriate 
+      issue type: 
+
+      - If you encounter a bug, select :guilabel:`Bug`.
+
+      - If you have a new feature request, select :guilabel:`New Feature`.
+
+   .. step:: Provide a summary. 
+
+      In the :guilabel:`Summary` field, provide a brief summary of the bug or
+      feature request. 
+      
+   .. step:: Provide a description. 
+      
+      In the :guilabel:`Description` field, you can provide more detailed 
+      information, including the exact steps needed to reproduce the issue. 
+
+   .. step:: Set the label field.
+
+      In the :guilabel:`Labels` field, include the ``internal-preview`` label.
+
+   .. step:: (*Optional*) Add logs in the Attachment field.
+
+      Logs can help navigate edge cases and diagnose issues in the 
+      {+intellij-short+}. For more information, see :ref:`intellij-logs`.
+
+   .. step:: Submit the ticket.
+
+      Click :guilabel:`Create` to submit the ticket.
+
+Vote on Submitted Tickets
+-------------------------
+
+Under the :guilabel:`People` section on the right side of the JIRA ticket, you 
+can vote for tickets. Issues with more votes are more likely to be prioritized 
+by the MongoDB development team. 
+
+.. toctree::
+   :titlesonly:
+
+   Logs </logs>