(DOCSP-7600): insertOne usage example(#17)

* (DOCSP-7600): insertOne init

* fixed pr to address comments

* removed unneeded additional options

* removed bypassschema from insertmany because we dont want that option

* fixed wording

* updated wording

Author: Mohammad Hunan Chughtai

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

@@ -21,7 +21,6 @@ async function run() {
     const docs = [docOne, docTwo, docThree];
     // specify an additional options object
     const options = {};
-    options.bypassDocumentValidation = true; // bypass document validation
     options.ordered = true; // prevent additional documents from being prevented if one fails
     const result = await collection.insertMany(docs, options);
     console.log(`${result.insertedCount} documents were inserted`);

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

@@ -0,0 +1,26 @@
+// ignored first line
+const { MongoClient } = require("mongodb");
+
+const uri =
+  "mongodb+srv://<user>:<password>@<cluster-url>?retryWrites=true&w=majority";
+
+const client = new MongoClient(uri);
+
+async function run() {
+  try {
+    await client.connect();
+
+    const database = client.db("sample_mflix");
+    const collection = database.collection("movies");
+    // create a document object
+    const doc = { name: "Red", town: "kanto" };
+    const result = await collection.insertOne(doc);
+
+    console.log(
+      `${result.insertedCount} documents were inserted with the _id: ${result.insertedId}`,
+    );
+  } finally {
+    await client.close();
+  }
+}
+run().catch(console.dir);

source/usage-examples.txt

@@ -6,19 +6,20 @@ Usage Examples
 
 :doc:`bulkWrite </usage-examples/bulkWrite>`
 :doc:`deleteMany </usage-examples/deleteMany>`
+:doc:`insertOne </usage-examples/insertOne>`
 :doc:`deleteOne </usage-examples/deleteOne>`
 :doc:`find </usage-examples/find>`
 :doc:`findOne </usage-examples/findOne>`
 :doc:`insertMany </usage-examples/insertMany>`
 :doc:`updateOne</usage-examples/updateOne>`
 
-
 .. toctree::
    :caption: Examples
 
    /usage-examples/bulkWrite
    /usage-examples/deleteMany
    /usage-examples/deleteOne
+   /usage-examples/insertOne
    /usage-examples/find
    /usage-examples/findOne
    /usage-examples/findOneAndUpdate

source/usage-examples/insertMany.txt

@@ -9,11 +9,9 @@ You can create multiple documents using the `insertMany()
 method. The ``insertMany()`` takes an array of documents to insert into
 the specified collection.
 
-Create an `Object
+You can create an `Object
 <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object>`_
-to specify additional options.  Set the ``bypassDocumentValidation``
-field to bypass :manual:`schema validation <core/schema-validation/>`
-rules in MongoDB 3.2 or higher. Specify ``ordered:true`` to prevent
+to specify additional options. Specify ``ordered:true`` to prevent
 inserting the remaining documents if the insertion failed for a previous
 document in the array.
 

source/usage-examples/insertOne.txt

@@ -0,0 +1,21 @@
+=================
+Create a Document
+=================
+
+.. default-domain:: mongodb
+
+To create a document, define an object variable with the fields and values that you want to specify. You can insert this document into a collection using the `insertOne()
+<https://mongodb.github.io/node-mongodb-native/3.3/api/Collection.html#insertOne>`_
+method. If the specified collection does not exist, the
+``insertOne()`` method creates the collection. 
+
+The ``insertOne()`` method returns a `Promise
+<https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise>`_
+that resolves to an object. The ``insertedId`` field of this object is
+the ``_id`` of the inserted document. The ``insertedCount`` field of
+this object has a value of 0 if a document was not created, and a value
+of 1 if a document was created.
+
+.. literalinclude:: /code-snippets/usage-examples/insertOne.js
+  :language: javascript
+  :linenos: