Merge pull request #59 from steveren/DOCSP-2589

DOCSP2589: MongoDB Instance page revisions

Author: steveren

source/collections.txt

@@ -26,7 +26,7 @@ for a database, either:
 .. figure:: /images/compass/select-database-1.svg
   :figwidth: 802px
 
-\- **or** -
+- **or** -
 
 - Click on a database in the left-hand pane:
 

source/databases.txt

@@ -19,17 +19,16 @@ Databases Tab
 
 The :guilabel:`Databases` tab lists the existing databases for your
 MongoDB deployment. To access the :guilabel:`Databases` tab, click the
-connection home |home| on the left hand pane and click the
+:guilabel:`Home` icon in the upper left corner and select the
 :guilabel:`Databases` tab.
 
-.. figure:: /images/compass/database-view1.svg
-  :figwidth: 802px
+.. figure:: /images/compass/database-tab.png
+  :figwidth: 700px
 
-From this tab, in addition to viewing the current databases, you can
+In addition to viewing the current databases, you can
 also create or delete databases.
 
-.. figure:: /images/compass/database-view.svg
-  :figwidth: 778px
+
 
 .. _create-database:
 
@@ -44,23 +43,3 @@ Drop a Database
 ---------------
 
 .. include:: /includes/steps/delete-database.rst
-
-View Collection/Index Information for a Database
-------------------------------------------------
-
-To view a list of collections for a database, either:
-
-- Click on a database in the :guilabel:`Databases` tab:
-
-.. figure:: /images/compass/select-database-1.svg
-  :figwidth: 802px
-
-\- **or** -
-
-- Click on a database in the left-hand pane:
-
-.. figure:: /images/compass/select-database-2.svg
-  :figwidth: 802px
-
-
-.. |home| unicode:: U+2302

source/images/compass/database-tab.png

@@ -1,32 +1,60 @@
-================
-MongoDB Instance
-================
+============
+Compass Home
+============
 
 .. default-domain:: mongodb
 
-Once connected to a MongoDB instance, the home |home| on the left hand
-pane provides details regarding the MongoDB instance, such as:
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
 
-- the connection name if the connection is a favorite connection or "My
-  Cluster" otherwise.
+The Compass Home screen provides details regarding the
+MongoDB instance to which Compass is connected, including:
 
-- the deployment type (standalone, replica set, sharded cluster). If
+- The connection name if the connection is a favorite connection,
+  or "My Cluster" otherwise.
+
+- The deployment type (standalone, replica set, sharded cluster). If
   the deployment is a replica set and the replica set name is specified
   in the connection window, the number of replica set members will also
   be displayed.
 
-- the hostname and port, as well as the version of MongoDB.
+- The hostname and port, as well as the version of MongoDB.
+
+- A list of the instance's :doc:`databases </databases>`.
+
+- Performance statistics, including memory usage, operation counts,
+  and slowest operations. *(Not Available in Compass Community
+  Edition)*
+
+Once connected to a MongoDB instance, you can reach the Compass
+Home screen by clicking the :guilabel:`Home` icon in the upper left
+corner.
 
-.. figure:: /images/compass/instance-view.svg
-  :figwidth: 800px
+Databases Tab
+-------------
 
-From the instance home, you can access:
+The :guilabel:`Databases` tab of the Home screen shows a list of all
+the databases on the current connection, with each one's storage size,
+number of collections, and number of indexes. For more information
+about the :guilabel:`Databases` tab, see :doc:`Databases </databases>`.
 
-- The :ref:`Databases <database-tab>` tab to view and manage the
-  databases in the deployment, and
+.. _performance-tab:
 
-- The :ref:`Server Performance <performance-tab>` tab to view real time
-  server stats. *Not Available in Compass Community Edition*
+Performance Tab
+---------------
+
+The :guilabel:`Performance` tab provides real-time server
+performance statistics and graphs, showing insights such as:
+
+- Which database collections receive the most operations
+- Which operations take the longest to execute
+- Memory utilization
+
+For more information about the :guilabel:`Performance` tab, see
+:doc:`Performance </performance>`.
 
 .. class:: hidden
 
@@ -35,5 +63,3 @@ From the instance home, you can access:
 
       /databases
       /performance
-
-.. |home| unicode:: U+2302

source/instance.txt

@@ -1,6 +1,6 @@
-==================
-Server Performance
-==================
+===========
+Performance
+===========
 
 .. default-domain:: mongodb
 
@@ -17,9 +17,9 @@ Server Performance
 Performance Tab
 ---------------
 
-To access the real-time server performance view, click the connection
-home |home| on the left hand pane to go to the :guilabel:`Performance`
-tab.
+To access the real-time server performance view, click the
+:guilabel:`Home` icon in the upper left corner and select the
+:guilabel:`Performance` tab.
 
 .. figure:: /images/compass/performance-view.svg
   :figwidth: 700px
@@ -71,7 +71,7 @@ The :guilabel:`Performance` tab displays various stats:
      - Displays the collections with the most activities as reported
        by :binary:`mongotop <bin.mongotop>`. 
 
-       The collections corresponds to a given moment in the charts;
+       The collections correspond to a given moment in the charts;
        i.e. as you move over the charts, the corresponding collections
        are highlighted/displayed in the table.
 
@@ -80,18 +80,20 @@ The :guilabel:`Performance` tab displays various stats:
 
      - Displays the slowest operations as reported by
        :manual:`db.currentOp() </reference/method/db.currentOp>`. The
-       operations correspond to a moment in the charts; i.e. as you
-       move over the charts, the corresponding slowest operations are
-       displayed in the table. To view the details of a slow operation
-       as reported by :manual:`db.currentOp()
+       operations correspond to a given moment in the charts; i.e. as
+       you move over the charts, the corresponding slowest operations
+       are displayed in the table. To view the details of a slow
+       operation as reported by :manual:`db.currentOp()
        </reference/method/db.currentOp>`, click on the operation.
 
 Pause the Display
 ~~~~~~~~~~~~~~~~~
 
-The :guilabel:`Pause` button pauses the update of the displays only and
-does not pause the collection of the underlying data.
+The :guilabel:`Pause` button above the graph display pauses the update
+of the displays only. Pausing the performance tab does not impact the
+collection of the underlying data. To restart the display updates, click
+:guilabel:`Play`.
 
-To restart the display updates, click :guilabel:`Play`.
-
-.. |home| unicode:: U+2302
+Next to the :guilabel:`Pause` button is a clock which shows the
+current time while the graphs are updating. If the display is
+paused, the clock shows the time at which the pause began.