DOCSP-30630 Navigate Diagrams and Entities Drawer (#13)

* DOCSP-30630 Navigate Diagrams and Entities Drawer

Author: ianf-mongodb

source/diagrams/navigate-diagrams/apply-layout.txt

@@ -1,3 +1,55 @@
+.. _rm-apply-layout:
+
 ===========================
 Apply a Layout to a Diagram
-===========================
+===========================
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+You can apply a preset layout to your diagram to organize its entities.
+Use diagram layouts to neatly arrange entities without needing to
+manually click and drag them.
+
+About this Task
+---------------
+
+When you apply a layout to a diagram, Relational Migrator applies the
+layout to both the Relational and MongoDB views. The zoom level is
+automatically adjusted to display your chosen layout.
+
+Steps
+-----
+
+#. Click the tree diagram icon at the top-left of the :guilabel:`diagram` view.
+
+#. Choose your layout.
+
+Layout Options
+--------------
+
+Relational Migrator offers three layout options. 
+Examples of each layout option are shown in the following tabs:
+
+.. tabs::
+
+   .. tab:: Left to Right Layout
+      :tabid: left-to-right
+
+      .. image:: /img/diagrams/layouts/left-to-right.png
+         :alt: Left to Right Layout
+
+   .. tab:: Top to Bottom Layout
+      :tabid: top-to-bottom
+
+      .. image:: /img/diagrams/layouts/top-to-bottom.png
+         :alt: Top to Bottom Layout
+
+   .. tab:: Star Layout
+      :tabid: star
+
+      .. image:: /img/diagrams/layouts/star.png
+         :alt: Star Layout

source/diagrams/navigate-diagrams/navigate-diagrams.txt

@@ -2,9 +2,75 @@
 Navigate Diagrams and Entities
 ==============================
 
+This page describes how to navigate your project's diagrams and
+entities.
+
+After you :ref:`create a project<rm-create-project-live>`, Relational
+Migrator creates an initial diagram containing the entities and
+relationships in the Relational and MongoDB models.
+
+If you have a large data model, you can create additional diagrams to
+separate the model into smaller subsets. When you have multiple diagrams
+in your project, Relational Migrator lists the diagram names in tabs at
+the top of the workspace.
+
+.. note::
+
+   Diagram tabs appear in the order that the diagrams were created. You
+   cannot reorder diagram tabs.
+
+Change the Active Diagram
+-------------------------
+
+The active diagram is the diagram currently displayed by Relational
+Migrator.
+
+To change the active diagram, click the tab for the diagram you want to
+view.
+
+Navigate Diagram Entities
+-------------------------
+
+Diagrams are made up of entities. An entity is either a Relational or
+MongoDB database object.
+
+Relational Migrator provides these modes for navigating entities in a
+diagram:
+
+- Pan Mode
+- Multi-Select Mode
+
+Pan Mode
+~~~~~~~~
+
+In Pan Mode, you can click and drag the diagram to navigate to different
+areas. When you click a diagram entity, Relational Migrator shows
+mapping details for that entity in the right pane.
+
+Pan Mode is the default view mode. When you are in Pan Mode, Relational
+Migrator highlights the arrow icon at the top of the diagram.
+
+Multi-Select Mode
+~~~~~~~~~~~~~~~~~
+
+In Multi-Select Mode, you can select multiple diagram entities by
+clicking and dragging the diagram to create a select box. When you
+select multiple entities, Relational Migrator shows the selected
+entities in the right pane. When multiple entities are selected, you
+cannot see any mapping details.
+
+To enter Multi-Select Mode, press and hold :guilabel:`Shift`. When you are in
+Multi-Select Mode, Relational Migrator highlights the box icon at the
+top of the diagram. When you release the shift key, Relational Migrator
+returns to Pan Mode.
+
+Learn More
+----------
+
+:ref:`rm-apply-layout`
+
 .. toctree::
    :hidden:
    :titlesonly:
 
-   /diagrams/navigate-diagrams/apply-layout
-   /diagrams/navigate-diagrams/working-with-entities/working-with-entities
+   /diagrams/navigate-diagrams/apply-layout

source/projects/create-project-live-connection.txt

@@ -1,3 +1,5 @@
+.. _rm-create-project-live:
+
 =================================================
 Create a Project By Connecting to a Live Database
 =================================================