Merge pull request #46 from ianf-mongodb/DOCSP-27700

DOCSP-27700 Manage the Relation Model Refactor

Author: jason-price-mongodb

snooty.toml

@@ -31,5 +31,6 @@ toc_landing_pages = [
 "code-generation/code-generation"
 ]
 
-# [constants]
-# constant = "value"
+[constants]
+ddl = ":abbr:`DDL (Data Definition Language)`"
+

source/projects/manage-relational-connection.txt

@@ -9,13 +9,13 @@ Manage the Relational Model
 .. contents:: On this page
    :local:
    :backlinks: none
-   :depth: 1
+   :depth: 2
    :class: singlecol
 
-You can use the :guilabel:`Manage` button on the :guilabel:`Schema model` pane to 
-make changes to the schemas or tables you want to include in 
+You can use the :guilabel:`Manage` button on the :guilabel:`Schema model` 
+pane to make changes to the schemas or tables you want to include in 
 your migration project. You can also connect to the source database 
-or use a DDL file to refresh the list of available tables.
+or use a {+ddl+} file to refresh the list of available tables.
 
 Add or Remove Tables from a Project
 -----------------------------------
@@ -28,40 +28,44 @@ the :guilabel:`Manage` button.
 
 #. Click the check box next to the schema or schemas you are migrating. 
 
-#. To expand the tables in a schema, click ``>``.
+#. To expand the tables in a schema, click the :icon-fa5:`chevron-right`
+   button.
 
    Select the tables you want to add or remove from your migration.
 
 #. Click :guilabel:`Save`. 
 
    Changes from your relational database are reflected in the main 
-   Relational Migrator diagram and included in future migration jobs.
+   Relational Migrator diagram and included in future sync jobs.
 
 Refresh Schema Changes
 ----------------------
 
-If your relational database table structure changes, use the :guilabel:`Refresh Schema` button to let Relational Migrator know. 
+If your relational database table structure changes, use the 
+:guilabel:`Refresh Schema` button to let Relational Migrator know. 
 
-1. From the :guilabel:`Mapping` screen, click the :guilabel:`Manage` button on the 
-   :guilabel:`Schema model` pane.
+1. From the :guilabel:`Mapping` screen, click the :guilabel:`Manage` 
+   button on the :guilabel:`Schema model` pane.
 
-#. Click the :guilabel:`Refresh schema` button on the Manage relational model modal.
+#. Click the :guilabel:`Refresh schema` button on the Manage 
+   relational model modal.
 
-#. Select either :ref:`Connect DB <connect-db>` or :ref:`Import DDL File  <import-ddl-file>`.
+#. Select either :ref:`Connect to database <connect-to-db>` or 
+   :ref:`Import DDL File  <import-ddl-file>`.
 
-.. _connect-db:
+.. _connect-to-db:
 
-Connect DB 
-~~~~~~~~~~~
+Connect to database
+~~~~~~~~~~~~~~~~~~~
 
-:guilabel:`Connect DB` rescans the schema. Changes in foreign key relations or data 
-types for the underlying tables are read into Migrator.
+:guilabel:`Connect to database` rescans the schema. Changes in foreign key 
+relations or data types for the underlying tables are read into Migrator.
 
-1. Input the :guilabel:`JDBC URI`, :guilabel:`Username` and :guilabel:`Password` 
-   for the database instance you are connecting to. 
+1. Input the :guilabel:`JDBC URI`, :guilabel:`Username` and 
+   :guilabel:`Password` for the database instance you are connecting to. 
 
-   The account used can be different from the credentials you used when creating 
-   the project.
+   The account used can be different from the credentials you used when 
+   creating the project.
 
    .. note::
 
@@ -74,14 +78,14 @@ types for the underlying tables are read into Migrator.
 
    Any changes from your relational database are reflected in 
    the main Relational Migrator diagram and included in future 
-   migration jobs.
+   sync jobs.
 
 .. _import-ddl-file:
 
 Import DDL File
 ~~~~~~~~~~~~~~~
 
-:guilabel:`Import DDL File` opens a file prompt that accepts a DDL file of the 
+:guilabel:`Import DDL File` opens a file prompt that accepts a {+ddl+} file of the 
 relational schema you are migrating. Any changes in the foreign key relations or 
 data types for the underlying tables are read into Migrator.
 
@@ -95,11 +99,11 @@ data types for the underlying tables are read into Migrator.
    - PostgreSQL
    - SQL Server
 
-#. Choose a file or drag and drop a DDL statement file.
+#. Choose a file or drag and drop a {+ddl+} statement file.
 
 #. Click :guilabel:`Import`.
 
 #. Click :guilabel:`Save`. 
 
    Any changes from your relational database are reflected in the main 
-   Relational Migrator diagram and included in future migration jobs.
+   Relational Migrator diagram and included in future sync jobs.