Updating the Mongoose article with DB level throughput

Author: LuisBosquez

articles/cosmos-db/media/mongodb-mongoose/db-level-throughput.png

@@ -30,6 +30,14 @@ Let's create a Cosmos account. If you already have an account you want to use, y
 
 [!INCLUDE [cosmos-db-create-dbaccount-mongodb](../../includes/cosmos-db-create-dbaccount-mongodb.md)]
 
+### Create a database 
+In this application we will cover two ways of creating your collections on Cosmos DB: 
+- **Storing each object model in a separate collection**: We recommend [creating a database with dedicated throughput](set-throughput.md#set-throughput-on-a-database). Using this capacity model will give you better cost efficiency. 
+![Node.js tutorial - Screenshot of the Azure portal, showing how to create a database in the Data Explorer for an Azure Cosmos DB account, for use with the Mongoose Node module][db-level-throughput.png]
+- **Storing all object models in a single Cosmos DB collection**: If you'd prefer to store all models in a single collection, you can just create a new database without selecting the Provision Throughput option. Using this capacity model will create each collection with its own throughput capacity for every object model.
+
+After you create the database, you'll use the name in the `COSMOSDB_DBNAME` environment variable below.
+
 ## Set up your Node.js application
 
 >[!Note]
@@ -41,8 +49,8 @@ Let's create a Cosmos account. If you already have an account you want to use, y
 
     Answer the questions and your project will be ready to go.
 
-1. Add a new file to the folder and name it ```index.js```.
-1. Install the necessary packages using one of the ```npm install``` options:
+2. Add a new file to the folder and name it ```index.js```.
+3. Install the necessary packages using one of the ```npm install``` options:
    * Mongoose: ```npm install mongoose@5 --save```
 
      > [!Note]
@@ -53,26 +61,26 @@ Let's create a Cosmos account. If you already have an account you want to use, y
      >[!Note]
      > The ```--save``` flag adds the dependency to the package.json file.
 
-1. Import the dependencies in your index.js file.
+4. Import the dependencies in your index.js file.
 
     ```JavaScript
    var mongoose = require('mongoose');
    var env = require('dotenv').config();   //Use the .env file to load the variables
     ```
 
-1. Add your Cosmos DB connection string and Cosmos DB Name to the ```.env``` file. Replace the placeholders {cosmos-account-name} and {dbname} with your own Cosmos account name and database name, without the brace symbols.
+5. Add your Cosmos DB connection string and Cosmos DB Name to the ```.env``` file. Replace the placeholders {cosmos-account-name} and {dbname} with your own Cosmos account name and database name, without the brace symbols.
 
     ```JavaScript
    # You can get the following connection details from the Azure portal. You can find the details on the Connection string pane of your Azure Cosmos account.
 
-   COSMODDB_USER = "<Azure Cosmos account's user name>"
-   COSMOSDB_PASSWORD = "<Azure Cosmos account passowrd>"
+   COSMODDB_USER = "<Azure Cosmos account's user name, usually the database account name>"
+   COSMOSDB_PASSWORD = "<Azure Cosmos account password, this is one of the keys specified in your account>"
    COSMOSDB_DBNAME = "<Azure Cosmos database name>"
    COSMOSDB_HOST= "<Azure Cosmos Host name>"
    COSMOSDB_PORT=10255
     ```
 
-1. Connect to Cosmos DB using the Mongoose framework by adding the following code to the end of index.js.
+6. Connect to Cosmos DB using the Mongoose framework by adding the following code to the end of index.js.
     ```JavaScript
    mongoose.connect("mongodb://"+process.env.COSMOSDB_HOST+":"+process.env.COSMOSDB_PORT+"/"+process.env.COSMOSDB_DBNAME+"?ssl=true&replicaSet=globaldb", {
       auth: {
@@ -88,19 +96,15 @@ Let's create a Cosmos account. If you already have an account you want to use, y
 
     Once you are connected to Azure Cosmos DB, you can now start setting up object models in Mongoose.
 
-## Caveats to using Mongoose with Cosmos DB
-
-For every model you create, Mongoose creates a new collection. However, given the per-collection billing model of Cosmos DB, it might not be the most cost-efficient way to go, if you've got multiple object models that are sparsely populated.
-
-This walkthrough covers both models. We'll first cover the walkthrough on storing one type of data per collection. This is the defacto behavior for Mongoose.
+## Best practices for using Mongoose with Cosmos DB
 
-Mongoose also has a concept called [Discriminators](https://mongoosejs.com/docs/discriminators.html). Discriminators are a schema inheritance mechanism. They enable you to have multiple models with overlapping schemas on top of the same underlying MongoDB collection.
+For every model you create, Mongoose creates a new collection. This is best addressed using the [Database Level Throughput option](https://docs.microsoft.com/en-us/azure/cosmos-db/set-throughput#set-throughput-on-a-database), which was previously discussed. To use  a single collection, you need to use Mongoose [Discriminators](https://mongoosejs.com/docs/discriminators.html). Discriminators are a schema inheritance mechanism. They enable you to have multiple models with overlapping schemas on top of the same underlying MongoDB collection.
 
-You can store the various data models in the same collection and then use a filter clause at query time to pull down only the data needed.
+You can store the various data models in the same collection and then use a filter clause at query time to pull down only the data needed. Let's walk through each of the models.
 
 ### One collection per object model
 
-The default Mongoose behavior is to create a MongoDB collection every time you create an Object model. This section explores how to achieve this with Azure Cosmos DB's API for MongoDB. This method is recommended when you have object models with large amounts of data. This is the default operating model for Mongoose, so, you might be familiar with this, if you're familiar with Mongoose.
+This section explores how to achieve this with Azure Cosmos DB's API for MongoDB. This method is our recommended approach since it allows to control cost and capacity regardless of the amount of object models in your data. This is the default operating model for Mongoose, so, you might be familiar with this, if you're familiar with Mongoose.
 
 1. Open your ```index.js``` again.