DOCSP-27445: instantiate collection in fundamental pgs + implement "myColl" variable naming (#517)

* DOCSP-27445: instantiate collection in insert examples

* changed to myColl and/or instantiated collection

* agreement fixes

* MW PR fixes 1

* MW PR fixes 2

Author: rustagir

source/code-snippets/collation/aggregation-collation.js

@@ -1,4 +1,4 @@
-collection.aggregate(
+myColl.aggregate(
   [
     { $group: { "_id": "$first_name", "nameCount": { "$sum": 1 } } },
     { $sort: { "_id": 1 } },

source/code-snippets/collation/collection-collation.js

@@ -6,11 +6,11 @@ db.createCollection("souvenirs", {
 // end create collection with collation
 
 // start collection query without collation
-collection.find({type: "photograph"});
+myColl.find({type: "photograph"});
 // end collection query without collation
 
  // start collection query with collation
- collection.find({type: "photograph"},
+ myColl.find({type: "photograph"},
    { collation: { locale: "is", caseFirst: "upper" } }
  );
  // end collection query with collation

source/code-snippets/collation/find-sort-collation.js

@@ -1,2 +1,2 @@
-collection.find({ city: "New York" }, { collation: { locale: "de" } })
+myColl.find({ city: "New York" }, { collation: { locale: "de" } })
   .sort({ name: 1 });

source/code-snippets/collation/findOneAndDelete-collation.js

@@ -1,9 +1,9 @@
 // start findOneAndDelete example without collation
-await collection.findOneAndDelete({ a: { $gt: "100" } });
+await myColl.findOneAndDelete({ a: { $gt: "100" } });
 // end findOneAndDelete example without collation
 
 // start findOneAndDelete example with collation
-collection.findOneAndDelete(
+myColl.findOneAndDelete(
   { a: { $gt: "100" } },
   { collation: { locale: "en", numericOrdering: true } },
 );

source/code-snippets/collation/findOneAndUpdate-collation.js

@@ -1,12 +1,12 @@
 // start findOneAndUpdate without collation
-collection.findOneAndUpdate(
+myColl.findOneAndUpdate(
   { first_name : { $lt: "Gunter" } },
   { $set: { verified: true } }
 );
 // end findOneAndUpdate without collation
 
 // start findOneAndUpdate with collation
-collection.findOneAndUpdate(
+myColl.findOneAndUpdate(
   { first_name: { $lt: "Gunter" } },
   { $set: { verified: true } },
   { collation: { locale: "de@collation=phonebook" } },

source/code-snippets/collation/index-collation.js

@@ -1,3 +1,3 @@
-collection.createIndex(
+myColl.createIndex(
   { 'title' : 1 },
   { 'collation' : { 'locale' : 'en_US' } });

source/code-snippets/collation/query-index-collation.js

@@ -1,14 +1,14 @@
 // start query index collation
-collection.find({"year": 1980}, {"collation" : {"locale" : "en_US" }})
+myColl.find({"year": 1980}, {"collation" : {"locale" : "en_US" }})
   .sort({"title": -1});
 // end query index collation
 
 // start query without index collation
 // no collation specified
-collection.find({"year": 1980})
+myColl.find({"year": 1980})
   .sort({"title": -1});
 
 // collation differs from the one on the index
-collection.find({"year": 1980}, {"collation" : {"locale" : "en_US", "strength": 2 }})
+myColl.find({"year": 1980}, {"collation" : {"locale" : "en_US", "strength": 2 }})
   .sort({"title": -1});
 // end query without index collation

source/code-snippets/crud/cursor.js

@@ -6,60 +6,60 @@ const uri =
   "mongodb+srv://<user>:<password>@<cluster-url>?writeConcern=majority";
 const client = new MongoClient(uri);
 
-async function forEachIteration(collection) {
+async function forEachIteration(myColl) {
   // start foreach cursor example
-  const cursor = collection.find({});
+  const cursor = myColl.find({});
   await cursor.forEach(doc => console.log(doc));
   // end foreach cursor example
   console.log(await cursor.count());
 }
 
-async function asyncIteration(collection) {
+async function asyncIteration(myColl) {
   // start async cursor example
-  const cursor = collection.find({});
+  const cursor = myColl.find({});
   console.log("async");
   for await (const doc of cursor) {
     console.log(doc);
   }
   // end async cursor example
 }
 
-async function manualIteration(collection) {
+async function manualIteration(myColl) {
   // start manual cursor example
-  const cursor = collection.find({});
+  const cursor = myColl.find({});
 
   while (await cursor.hasNext()) {
     console.log(await cursor.next());
   }
   // end manual cursor example
 }
 
-async function streamAPI(collection) {
+async function streamAPI(myColl) {
   // start stream cursor example
-  const cursor = collection.find({});
+  const cursor = myColl.find({});
   cursor.stream().on("data", doc => console.log(doc));
   // end stream cursor example
 }
 
-async function eventAPI(collection) {
+async function eventAPI(myColl) {
   // start event cursor example
-  const cursor = collection.find({});
+  const cursor = myColl.find({});
   // the "data" event is fired once per document
   cursor.on("data", data => console.log(data));
   // end event cursor example
 }
 
-async function fetchAll(collection) {
+async function fetchAll(myColl) {
   // start fetchAll cursor example
-  const cursor = collection.find({});
+  const cursor = myColl.find({});
   const allValues = await cursor.toArray();
   // end fetchAll cursor example
   console.log(allValues.length);
 }
 
-async function rewind(collection) {
+async function rewind(myColl) {
   // start rewind cursor example
-  const cursor = collection.find({});
+  const cursor = myColl.find({});
   const firstResult = await cursor.toArray();
   console.log("First count: " + firstResult.length);
   await cursor.rewind();
@@ -68,9 +68,9 @@ async function rewind(collection) {
   // end rewind cursor example
 }
 
-async function count(collection) {
+async function count(myColl) {
   // start count cursor example
-  const cursor = collection.find({});
+  const cursor = myColl.find({});
   const count = await cursor.count();
   // end count cursor example
   console.log(count);

source/code-snippets/typescript/dot-notation.ts

@@ -3,23 +3,23 @@ interface TestType {
   field: { nested: number };
 }
 const database = client.db("<your db>");
-const collection = database.collection<TestType>("<your collection>");
-await collection.updateOne({}, { $set: { "field.nested": "A string" } });
+const myColl = database.collection<TestType>("<your collection>");
+await myColl.updateOne({}, { $set: { "field.nested": "A string" } });
 // end-no-error
 // start-error
 interface TestType {
   field: { nested: number };
 }
 const database = client.db("<your db>");
-const collection = database.collection<TestType>("<your collection>");
-await collection.updateOne({}, { $set: { field: { nested: "A string" } } });
+const myColl = database.collection<TestType>("<your collection>");
+await myColl.updateOne({}, { $set: { field: { nested: "A string" } } });
 // end-error
 // start-no-key
 interface User {
   email: string;
 }
 
 const database = client.db("<your database>");
-const collection = db.collection<User>("<your collection>");
-collection.find({ age: "Accepts any type!" });
+const myColl = db.collection<User>("<your collection>");
+myColl.find({ age: "Accepts any type!" });
 // end-no-key

source/code-snippets/usage-examples/changeStream.js

@@ -9,10 +9,10 @@ let changeStream;
 async function run() {
   try {
     const database = client.db("insertDB");
-    const collection = database.collection("haikus");
+    const haikus = database.collection("haikus");
 
     // Open a Change Stream on the "haikus" collection
-    changeStream = collection.watch();
+    changeStream = haikus.watch();
 
     // Print change events
     for await (const change of changeStream) {