proofread

Author: kyuan-mongodb

source/includes/odbc-manager-keywords.rst

@@ -1,4 +1,4 @@
-a. Add a keyword value pair by clicking the :guilabel:`Add` button.
+i. Add a keyword value pair by clicking the :guilabel:`Add` button.
 
 #. Modify the :guilabel:`Keyword` by double-clicking on it, entering
    the desired keyword, then pressing enter.

source/includes/steps-connect-tableau-mongosql-ssl-windows.yaml

@@ -16,7 +16,7 @@ content: |
   :abbr:`DSN (Data Source Name)` configured to use the {+odbc-driver+} 
   is required. To create a system DSN, follow the steps below:
   
-  .. include:: /includes/steps-create-system-dsn.rst
+  .. include:: /includes/steps-create-system-dsn-lettered.rst
 
 ---
 ref: start-tableau-windows

source/includes/steps-create-system-dsn-lettered.rst

@@ -0,0 +1,132 @@
+a. Start the Microsoft ODBC Data Sources program.
+   
+   Choose the program version (64-bit or 32-bit) which is
+   appropriate for your system and ODBC driver version.
+
+#. Select the ``System DSN`` tab. 
+
+#. Click the ``Add`` button. 
+
+   .. figure:: /images/bi-connector/windows-odbc-administrator.png
+      :alt: Screenshot of the Windows ODBC Administrator application
+      :figwidth: 550px
+
+#. Select a |odbc-driver-name| from the list of available drivers.
+   
+   Select either the :guilabel:`MongoDB ODBC ANSI Driver` or the
+   :guilabel:`MongoDB ODBC Unicode Driver`, then click
+   :guilabel:`OK`.
+
+   .. include:: /includes/fact-ansi-unicode-driver.rst
+
+#. Fill in the necessary form fields. 
+   
+   Click the :guilabel:`Details` button to expose the lower half of the form.
+
+   The following form fields are required:
+
+   .. list-table::
+      :header-rows: 1
+      :widths: 30 70
+
+      * - Field Name
+        - Description
+
+      * - :guilabel:`Data Source Name`
+        - A name of your choice.
+
+      * - :guilabel:`TCP/IP Server`
+        - Address of the server where your
+          :binary:`~bin.mongosqld` process is running. If you have enabled
+          |bi-short| on `MongoDB Atlas
+          <https://www.mongodb.com/cloud/atlas>`_, you can find the
+          hostname of the server where :binary:`~bin.mongosqld` is running
+          in the `connection information
+          <https://docs.atlas.mongodb.com/connect-to-cluster/#connect-to-your-cluster>`_
+          for your cluster.
+
+      * - :guilabel:`Port`
+        - Port number of your :binary:`~bin.mongosqld`
+          process.
+
+      * - :guilabel:`Database`
+        - The name of the database to connect to, e.g. ``test``.
+
+#. (Optional) If authentication is enabled, provide connection information.
+
+   The following fields are required when running with
+   :option:`--auth <mongosqld --auth>` enabled or when connecting to an
+   {+bi-atlas-short+} instance.
+   
+   .. list-table::
+      :header-rows: 1
+      :widths: 30 70
+
+      * - Field Name
+        - Description
+
+      * - :guilabel:`User`
+        - Username of the :manual:`MongoDB user </core/security-users/>`
+          who is authenticated to use your target database.
+
+          .. include:: /includes/auth-options.rst
+
+          .. include:: /includes/auth-mechanisms-example.rst
+
+      * - :guilabel:`Password`
+        - The authenticated user's password.
+
+          .. include:: /includes/fact-db-pwd-special-char.rst
+
+      * - :guilabel:`Authentication`
+        - The default authentication method. When using the
+          {+odbc-driver+}, this field is not required.
+
+          To use the :doc:`authentication plugin
+          </reference/auth-plugin-c>` in conjunction with
+          another ODBC driver, fill in this field with the
+          string ``mongosql_auth``.
+
+#. (Optional) If TLS/SSL is enabled, fill in the TLS/SSL form fields. 
+
+   Access the TLS/SSL form fields by clicking :guilabel:`Details >>`,
+   then the :guilabel:`SSL` tab. The following parameters are available
+   and may be required, depending on your
+   :ref:`TLS/SSL <msqld-mongodb-tls-options>` configuration:
+
+   .. list-table::
+      :header-rows: 1
+      :widths: 30 70
+
+      * - Field Name
+        - Description
+
+      * - :guilabel:`SSL Key`
+        - The location of the client/server key file.
+
+      * - :guilabel:`SSL Cert`
+        - The location of the client/server certificate file.
+
+      * - :guilabel:`SSL CA File`
+        - The location of the file containing a list of trusted
+          certificate authorities.
+
+      * - :guilabel:`SSL Cipher`
+        - The location of the file containing a list of permitted
+          ciphers.
+
+      * - :guilabel:`SSL Mode`
+        - Set to ``REQUIRED`` to require an encrypted channel. If an
+          encyrpted channel is not provided, the connection fails.
+
+      * - :guilabel:`RSA Public Key`
+        - The location of the PEM file that contains the RSA public key.
+
+   .. include:: /includes/fact-ssl-atlas-bic.rst
+
+#. Click the ``Test`` button to test the ODBC connection.
+   
+   If the connection is successful, click :guilabel:`OK` to add the
+   :abbr:`DSN (Data Source Name)`. If the connection fails,
+   check to make sure your MongoDB user is correctly authenticated for
+   the database named in the connection.

source/includes/steps-create-system-dsn-macos.rst

@@ -1,4 +1,4 @@
-a. Launch ODBC Manager.
+1. Launch ODBC Manager.
 
    .. note::