edits

Author: v-geberr

articles/cosmos-db/nosql/how-to-javascript-create-container.md

@@ -36,15 +36,21 @@ Once created, the URI for a container is in this format:
 Get a [Database](how-to-javascript-create-database.md) object, then create a [Container](/javascript/api/@azure/cosmos/container):
 
 * [createIfNotExists](/javascript/api/@azure/cosmos/containers#@azure-cosmos-containers-createifnotexists) - Creates a container if it doesn't exist. If it does exist, return container.
-* [create](/javascript/api/@azure/cosmos/containers#@azure-cosmos-containers-create) - Creates a container if it doesn't already exist. If it does exist, return error statusCode.
+* [create](/javascript/api/@azure/cosmos/containers#@azure-cosmos-containers-create) - Creates a container. If it does exist, return error statusCode.
 
 ```javascript
 const containerName = 'myContainer';
 
-// Create or get existing container
+// Possible results:
+// Create then return container
+// Return existing container
+// Return error statusCode
 const { statusCode, container } = await database.containers.createIfNotExists({ id: containerName });
 
-// Create or return error
+// Possible results: 
+// Create then return container
+// Return error statusCode, reason includes container already exists
+
 const { statusCode, container} = await database.containers.create({ id: containerName });
 ```
 

articles/cosmos-db/nosql/how-to-javascript-create-database.md

@@ -36,15 +36,20 @@ Once created, the URI for a database is in this format:
 Once you create the [CosmosClient](/javascript/api/@azure/cosmos/cosmosclient), use the client to create a [Database](/javascript/api/@azure/cosmos/database) from two different calls:
 
 * [createIfNotExists](/javascript/api/@azure/cosmos/databases#@azure-cosmos-databases-createifnotexists) - Creates a database if it doesn't exist. If it does exist, return database.
-* [create](/javascript/api/@azure/cosmos/databases#@azure-cosmos-databases-create) - Creates a database if it doesn't already exist. If it does exist, return error statusCode.
+* [create](/javascript/api/@azure/cosmos/databases#@azure-cosmos-databases-create) - Creates a database. If it does exist, return error statusCode.
 
 ```javascript
 const databaseName = 'myDb';
 
-// Create or get existing database
+// Possible results:
+// Create then return database
+// Return existing database
+// Return error statusCode
 const {statusCode, database } = await client.databases.createIfNotExists({ id: databaseName });
 
-// Create or return error status code
+// Possible results: 
+// Create then return database
+// Return error statusCode, reason includes database already exists
 const {statusCode, database } = await client.databases.create({ id: databaseName });
 ```
 

articles/cosmos-db/nosql/how-to-javascript-create-item.md

@@ -61,7 +61,7 @@ When referencing the item using a URI, use the system-generated *resource identi
 Create an item with the container's [items](/javascript/api/@azure/cosmos/container#@azure-cosmos-container-items) object using the [create](/javascript/api/@azure/cosmos/items) method.
 
 ```javascript
-const { statusCode, item, resource, activitId, etag} = await container.items.create({ 
+const { statusCode, item, resource, activityId, etag} = await container.items.create({ 
         id: '2', 
         category: 'gear-surf-surfboards',
         name: 'Sunnox Surfboard',
@@ -75,7 +75,7 @@ const { statusCode, item, resource, activitId, etag} = await container.items.cre
 Replace the data with the [Item](/javascript/api/@azure/cosmos/item) object with the [replace](/javascript/api/@azure/cosmos/item#@azure-cosmos-item-replace) method.
 
 ```javascript
-const { statusCode, item, resource, activitId, etag} = await item.replace({ 
+const { statusCode, item, resource, activityId, etag} = await item.replace({ 
         id: '2', 
         category: 'gear-surf-surfboards-retro',
         name: 'Sunnox Surfboard Retro',
@@ -86,18 +86,18 @@ const { statusCode, item, resource, activitId, etag} = await item.replace({
 
 ## Read an item
 
-Read the most current data with the [Item](/javascript/api/@azure/cosmos/item) object with the [read](/javascript/api/@azure/cosmos/item#@azure-cosmos-item-read) method.
+Read the most current data with the [Item](/javascript/api/@azure/cosmos/item) object's [read](/javascript/api/@azure/cosmos/item#@azure-cosmos-item-read) method.
 
 ```javascript
-const { statusCode, item, resource, activitId, etag} = await item.read();
+const { statusCode, item, resource, activityId, etag} = await item.read();
 ```
 
 ## Delete an item
 
-Delete the item with the [Item](/javascript/api/@azure/cosmos/item) object with the [delete](/javascript/api/@azure/cosmos/item#@azure-cosmos-item-read) method.
+Delete the item with the [Item](/javascript/api/@azure/cosmos/item) object's' [delete](/javascript/api/@azure/cosmos/item#@azure-cosmos-item-read) method.
 
 ```javascript
-const { statusCode, item, activitId, etag} = await item.delete();
+const { statusCode, item, activityId, etag} = await item.delete();
 ```
 
 ## Next steps