(DOCSP-9712): Navigate dbs, collections, documents (#2)

* (DOCSP-9712): Navigate dbs, collections, documents

* Updates per copy review

* Copy tweaks

Author: jeff-allen-mongo

snooty.toml

@@ -6,7 +6,6 @@ intersphinx = ["https://docs.mongodb.com/manual/objects.inv"]
 toc_landing_pages = ["/playgrounds"]
 
 [constants]
-vsce = "MongoDB for VS Code"
 
 [substitutions]
 
@@ -110,4 +109,5 @@ uri = ":abbr:`URI (Uniform Resource Identifier)`"
 url = ":abbr:`URL (Uniform Resource Locator)`"
 utc = ":abbr:`UTC (Coordinated Universal Time)`"
 vpc = ":abbr:`VPC (Virtual Private Cloud)`"
+vsce = "MongoDB for VS Code"
 yaml = ":abbr:`YAML (Yet Another Markup Language)`"

source/databases-collections.txt

@@ -1,13 +1,139 @@
 .. _vsce-databases-collections:
 
-==============================================
-Navigate Databases, Collections, and Documents
-==============================================
+==================
+Navigate Your Data
+==================
 
 .. default-domain:: mongodb
 
 .. contents:: On this page
    :local:
    :backlinks: none
-   :depth: 1
+   :depth: 2
    :class: singlecol
+
+Once you connect to your deployment using |vsce|, use the left
+navigation to:
+
+- Explore your databases, collections, read-only views, and documents. 
+
+- Create new databases and collections.
+
+- Drop databases and collections.
+
+.. figure:: /images/dbs-colls-docs.png
+  :figwidth: 300px
+  :alt: Image showing deployment navigation
+
+Databases and Collections
+-------------------------
+
+When you expand an active connection, |vsce| shows the databases in that
+deployment. Click a database to view the collections it contains.
+
+View Collection Documents and Schema
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Click a collection to view its documents and schema.
+
+Documents
+``````````
+
+When you expand a collection's documents, |vsce| lists the ``_id`` of
+each document in the collection. Click an ``_id`` value to open that
+document in VS Code and view its contents.
+
+.. note::
+
+   You cannot open a single document within a read-only view.
+
+Alternatively, right-click a collection and click
+:guilabel:`View Documents` to view all of the collection's documents
+in an array.
+
+Opening collection documents provides a **read-only** view of your data.
+To modify your data using |vsce|, use a JavaScript Playground.
+
+Schema
+``````
+
+Your collection's schema defines the fields and data types within the
+collection. Due to MongoDB's flexible schema model, different documents
+in a collection may contain different fields, and data types may vary
+within a field. MongoDB can enforce
+:manual:`schema validation </core/schema-validation/>` to ensure your
+collection documents have the same shape.
+
+When you expand a collection's schema, |vsce| lists the fields which
+appear in that collection's documents. If a field exists in all
+documents and its type is consistent throughout the collection, |vsce|
+displays an icon indicating that field's data type.
+
+Create a New Database
+~~~~~~~~~~~~~~~~~~~~~
+
+When you create a new database, you must populate it with an
+initial collection.
+
+To create a new database:
+
+1. Hover over the connection for the deployment where you want your
+   database to exist.
+
+#. Click the :icon-fa5:`plus` icon that appears.
+
+#. In the prompt, enter a name for your new database.
+
+#. Press the enter key.
+
+#. Enter a name for the first collection in your new database.
+
+#. Press the enter key.
+
+Create a New Collection
+~~~~~~~~~~~~~~~~~~~~~~~
+
+To create a new collection:
+
+1. Hover over the database where you want your collection to exist.
+
+#. Click the :icon:`plus` icon that appears.
+
+#. In the prompt, enter a name for your new collection.
+
+#. Press the enter key to confirm your new collection.
+
+Drop a Database or Collection
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. important::
+
+   Dropping data from MongoDB is an irreversible process. Take caution
+   to only drop data you are sure you want to delete, and backup your
+   data as necessary.
+
+   Dropping a database also drops all collections and documents within
+   that database.
+
+To drop a database or collection:
+
+1. Right-click the target database or collection.
+
+#. Click :guilabel:`Drop Database` or :guilabel:`Drop Collection`.
+
+#. In the prompt, type the name of the target database or collection.
+
+#. Press the enter key.
+
+Refresh Data
+------------
+
+You can refresh a deployment, database, or collection at any time to
+re-query your deployment and populate |vsce| with the most up-to-date
+data.
+
+To refresh:
+
+1. Right-click the target deployment, database, or collection.
+
+#. Click :guilabel:`Refresh`.

source/images/dbs-colls-docs.png

@@ -19,6 +19,7 @@ environment.
 
 .. figure:: /images/vsce-landing-2.png
   :figwidth: 700px
+  :alt: Image of MongoDB for VS Code
 
 Features
 --------