DOCSP-2579: assorted guides tweaks based on feedback (#74)

Author: skerschb

conf.py

@@ -36,7 +36,8 @@
     'guides',
     'tabs',
     'uriwriter',
-    'fasthtml'
+    'fasthtml',
+    'source_constants'
 ]
 
 templates_path = ['.templates']
@@ -59,6 +60,16 @@
     '.. |ent-build| replace:: MongoDB Enterprise',
 ])
 
+source_constants = {
+    'package-branch': 'testing',
+    'package-name-org': 'mongodb-org',
+    'package-name-enterprise': 'mongodb-enterprise',
+    'version': '4.0',
+    'release': 'release',
+    'pgp-version': '4.0',
+    'pgp-fingerprint': '9DA31620334BD75D9DCB49F368818C72E52529D4'
+}
+
 extlinks = {
     'issue': ('https://jira.mongodb.org/browse/%s', '' ),
     'manual': ('http://docs.mongodb.com/manual%s', ''),

source/guides/cloud/atlas.txt

@@ -1,12 +1,15 @@
 .. guide::
    title: Create an Atlas Account and Cluster
-   author: MongoDB
+   author: MongoDB Documentation Team
    type: Getting Started
    level: beginner
-   product_version: 3.6
+   product_version: 4.0
    result_description:
-     In this guide, you will create a free account on Atlas, MongoDB's
-     managed database solution, and a free MongoDB server cluster.
+     In this guide, you will:
+
+     - create a free account on Atlas, MongoDB's managed database solution in the cloud
+     - create a free MongoDB *cluster*, or group of database instances.
+   
    time: 15
    prerequisites:
      .. include:: /includes/steps/cloud_pr.rst

source/guides/cloud/connectionstring.txt

@@ -1,6 +1,6 @@
 .. guide::
    title: Set Up Atlas Connectivity
-   author: MongoDB
+   author: MongoDB Documentation Team
    type: Getting Started
    level: beginner
    languages:
@@ -12,7 +12,7 @@
      motor
      csharp
 
-   product_version: 3.6
+   product_version: 4.0
    result_description:
 
      This guide will show you how to set up your Atlas cluster for connections from a client. You will:
@@ -23,7 +23,7 @@
    time: 15
    prerequisites:
 
-     - You will need an Atlas account. See Getting Started: :doc:`/guides/cloud/atlas`
+     - You will need an Atlas account. See :doc:`/guides/cloud/atlas`
 
    procedure:
 

source/guides/server/auth.txt

@@ -0,0 +1,29 @@
+.. guide::
+
+   title: Enable Authentication on MongoDB
+   type: Getting Started
+   level: beginner
+   author: MongoDB Documentation Team
+   product_version: 4.0
+   result_description:
+     This guide describes how to enable authentication on your local MongoDB instance.
+   time: 10
+   prerequisites:
+     - A local installation of MongoDB. See :doc:`/guides/server/install`
+     - The :binary:`~bin.mongo` shell. See the mongo shell section of :doc:`/guides/server/drivers`
+   check_your_environment:
+     .. include:: /includes/check_for_auth.rst
+   procedure:
+     .. include:: /includes/steps/auth.rst
+   summary: 
+     If you have successfully completed this guide, you have
+     enabled basic authentication on your local MongoDB instance.
+   whats_next:
+     The next guide walks you through connecting to your new MongoDB instance.
+     - :doc:`/guides/server/drivers`
+   seealso:
+     - :doc:`/guides/server/introduction`
+     - :doc:`/guides/server/read`
+     - :doc:`/guides/server/read_operators`
+     - :doc:`/guides/server/update`
+     - :doc:`/guides/server/delete`

source/guides/server/delete.txt

@@ -3,8 +3,8 @@
    title: Delete Data from MongoDB
    type: Getting Started
    level: beginner
-   author: MongoDB
-   product_version: 3.6
+   author: MongoDB Documentation Team
+   product_version: 4.0
    languages:
      shell
      compass

source/guides/server/drivers.txt

@@ -1,8 +1,11 @@
 .. guide::
    title: Connect to MongoDB
-   author: MongoDB
+   author: MongoDB Documentation Team
    type: Getting Started
    level: beginner
+   deployments:
+     cloud
+     local
    languages:
      shell
      compass
@@ -12,20 +15,33 @@
      motor
      csharp
 
-   product_version: 3.6
+   product_version: 4.0
    result_description:
-     There are several ways to connect to your MongoDB instances. The
-     following guide steps you through installing your MongoDB client.
+     
+     There are several ways to connect to your MongoDB instance.
+      
+     - :ref:`MongoDB Compass <compass-index>` for access through a downloadable user interface
+     - :binary:`~bin.mongo` interactive shell
+     - `programmatic access <https://docs.mongodb.com/ecosystem/drivers>`_  through a number of programming APIs.
+
+    The following guide steps you through installing the MongoDB client of your choice.
 
    time: 15
    prerequisites:
-     .. include:: /includes/prereqs_drivers_install.rst
+
+     .. include:: /includes/prereqs_read_CRUD.rst
+   
    check_your_environment:
+
      - Ensure that your client platform is compatible with MongoDB. 
        Refer to the :ref:`Supported Platforms <mongodb-supported-platforms>`
        table for more information.
+   
    procedure:
 
+     .. tip:: 
+        Select the client and environment you will use at the top of this page.
+
      .. include:: /includes/steps/drivers_install_gs.rst
 
    summary:
@@ -41,7 +57,7 @@
      * :doc:`Insert Data into MongoDB </guides/server/insert>`
    seealso:
 
-     For CRUD guides:
+     For CRUD (Create, Read, Update, Delete) guides:
 
      - :doc:`/guides/server/insert`
      - :doc:`/guides/server/read`

source/guides/server/import.txt

@@ -1,9 +1,9 @@
 .. guide::
    title: Import Data into MongoDB
-   author: assorted
+   author: MongoDB Documentation Team
    type: Getting Started
    level: beginner
-   product_version: 3.6
+   product_version: 4.0
    result_description:
      In this guide, you will use the
      :binary:`~bin.mongoimport` tool distributed with MongoDB
@@ -22,7 +22,9 @@
    whats_next:
      In this guide, you will retrieve all of the documents in a
      collection in your MongoDB database.
-     * :doc:`Read Data From MongoDB </guides/server/read_queries>`
+     
+     - :doc:`Read Data From MongoDB </guides/server/read_queries>`
+     
    seealso:
      For CRUD guides:
 

source/guides/server/insert.txt

@@ -1,9 +1,9 @@
 .. guide::
    title: Insert Data into MongoDB
-   author: MongoDB
+   author: MongoDB Documentation Team
    type: Getting Started
    level: beginner
-   product_version: 3.6
+   product_version: 4.0
    languages:
      shell
      compass

source/guides/server/install.txt

@@ -4,7 +4,7 @@
    type: Getting Started
    level: beginner
    author: MongoDB Documentation Team
-   product_version: 3.6
+   product_version: 4.0
    result_description:
 
      This guide describes how to install MongoDB locally. If you would

source/guides/server/introduction.txt

@@ -1,11 +1,11 @@
 .. guide::
-   title: Introduction to MongoDB
-   author: MongoDB 
+   title: Structure your Data for MongoDB
+   author: MongoDB Documentation Team 
    type: Getting Started
    level: beginner
-   product_version: 3.6
+   product_version: 4.0
    result_description:
-     Welcome to the *Getting Started: Introduction to MongoDB* guide. This guide will show you how to structure your data for MongoDB.
+     Welcome to the Getting Started guides. This guide will show you how to structure data for MongoDB.
    time: 15
    prerequisites:
      - An idea of what data you'd like to store
@@ -16,10 +16,19 @@
    summary:
      Congratulations. You now have an idea of how to structure your data using a JSON document. 
    whats_next:
-     In the next guide, you'll learn how to Connect to MongoDB.
 
-     * :doc:`Getting Started: Connect to MongoDB </guides/server/drivers>`
+     Next you'll set up a MongoDB instance. Choose one of the following options:
+
+     - :doc:`Install MongoDB locally </guides/server/install>`
+
+     - :doc:`Create an Atlas Account and Cluster </guides/cloud/atlas>`
+
 
    seealso:
-     - :manual:`/schema-validation`
+     - :manual:`The MongoDB manual on Documents </core/document>`
+     - You can define the structure of your data for MongoDB using a JSON schema. See :manual:`Schema Validation </core/schema-validation>`.
+     - Read more about what MongoDB can do, see :manual:`Introduction to MongoDB </introduction>`
+
+     .. include:: /includes/beginner_note.rst
+