Merge pull request #94 from ianf-mongodb/DOCSP-36049

DOCSP-36049 AI and Data Usage Page

Author: jmd-mongo

source/code-generation.txt

@@ -42,12 +42,6 @@ application code:
      - 
       - ``C#``, ``Java``, ``JavaScript``, and ``JSON`` application code
 
-
-.. note::
-
-   Query Converter is currently in private preview. For sign-up details, 
-   see :ref:`rm-query-converter`.
-
 Get Started
 -----------
 

source/code-generation/query-converter.txt

@@ -15,19 +15,11 @@ procedures to MongoDB syntax. Relational Migrator considers the mapping
 rules and schema transformations defined in your project when converting
 your SQL code.
 
-Sign Up for Private Preview
----------------------------
-
-The Query Converter feature is in private 
-preview. To request private preview access, use the sign-up form within the
-Relational Migrator application:
-
-.. include:: /includes/fact-request-private-preview.rst
-
 .. toctree::
    :hidden:
    :titlesonly:
 
+   /code-generation/query-converter/ai-and-data-usage-information
    /code-generation/query-converter/enable-query-converter
    /code-generation/query-converter/convert-queries
    /code-generation/query-converter/convert-stored-procedures

source/code-generation/query-converter/ai-and-data-usage-information.txt

@@ -0,0 +1,59 @@
+.. _rm-ai-and-data-usage:
+
+=============================
+AI and Data Usage Information
+=============================
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+The Query Converter feature is powered by Generative AI
+(Gen AI), and may give inaccurate responses. Please see our `Generative AI FAQ 
+<https://dochub.mongodb.org/core/faq-ai-features>`__ 
+for more information about Gen AI in MongoDB products.
+
+Third Party Providers
+---------------------
+
+Query Converter currently uses the `Azure OpenAI Service
+<https://azure.microsoft.com/en-us/products/ai-services/openai-service>`__ 
+hosted by Microsoft. This is subject to change in the future.
+
+How Your Data is Used
+---------------------
+
+When you use Query Converter, the following information is sent to 
+MongoDB's backend and/or the third party AI provider:
+
+- The full text of your query or stored procedure.
+- The definition of any relational database tables used in the query.
+  These definitions include the table names, column names, data types,
+  and any primary or foreign key relationships.
+- The definition of your MongoDB collections and mapping rules. 
+  These definitions include the relationships between the collections 
+  and tables used in the query and the collection names, field names 
+  and data types.
+
+The information that is sent is not shared with any other third 
+parties or stored by the AI provider. Relational Migrator does not send 
+database connection strings, credentials, or any raw data from your 
+databases.
+
+By default, your original query text and the AI-converted query 
+telemetry data is stored by MongoDB for up to one year to help us 
+provide support and improve the service. If you do not want
+your data to be stored, you have the option to opt out:
+
+.. include:: /includes/fact-disable-query-converter.rst
+
+Disable Query Converter
+-----------------------
+
+Query Converter is available in the Relational Migrator UI once you have
+:ref:`enabled the query converter feature <rm-enable-query-converter>`. 
+If you no longer want to use the feature, you can ignore it and no data 
+will be sent to generative AI models. If needed, you can hide the 
+feature by clearing all browser data for the Relational Migrator host.

source/code-generation/query-converter/enable-query-converter.txt

@@ -15,14 +15,6 @@ stored procedures to MongoDB syntax. The query converter considers the
 mapping rules and schema transformations defined in your project when converting
 your SQL code.
 
-Before you Begin
-----------------
-
-The query converter feature is in private 
-preview. To request private preview access, use the sign-up form within the
-Relational Migrator application. For instructions, see 
-:ref:`rm-query-converter`.
-
 Steps
 -----
 
@@ -36,10 +28,19 @@ Steps
 
    .. step:: Read the user agreement
 
+   .. step:: (Optional) Review telemetry preferences
+
+      Telemetry data about the source and converted queries are 
+      temporarily stored by MongoDB to improve the query converter 
+      feature. If you do not want your data to be stored, you have 
+      the option to opt out:
+
+      .. include:: /includes/fact-disable-query-converter.rst
+
    .. step:: Enable the query converter feature
 
-      Click :guilabel:`Use Query Converter`. 
-      The :guilabel:`Query Converter` pane displays.
+      Click :guilabel:`Start Using Query Converter`. 
+      The :guilabel:`Query Converter` pane is displayed.
 
 Next Steps
 ----------

source/includes/fact-disable-query-converter.rst

@@ -0,0 +1,5 @@
+- You can disable the :guilabel:`Allow queries to be stored temporarily` 
+  toggle switch in the global project settings.
+- You can uncheck the :guilabel:`Allow MongoDB to temporarily store the 
+  source and converted queries to import the product feature` setting 
+  when you enable the query converter.