Update crud insert (#172)

Author: biniona-mongodb

source/crud/insert.txt

@@ -0,0 +1,97 @@
+:template: guide
+
+========================
+Insert Data into MongoDB
+========================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+Overview
+--------
+
+In this guide, you will insert data into MongoDB.
+
+.. time:: 15
+
+What You'll Need
+----------------
+
+.. include:: /includes/prereqs_read_CRUD.rst
+
+Check Your Environment
+----------------------
+
+.. include:: /includes/check_for_drivers_install.rst
+
+Procedure
+---------
+
+.. tabs-selector:: drivers
+
+.. procedure::
+   :style: normal
+
+   .. step:: Connect to Your MongoDB Instance
+
+      .. include:: /includes/drivers_connect.rst
+
+   .. step:: Switch to the ``test`` Database
+
+      .. include:: /includes/bind_db.rst
+
+   .. step:: Insert a Single Document
+
+      Now you are ready to create your first document in MongoDB.
+
+      MongoDB stores documents as BSON, a binary form of JavaScript Object
+      Notation ``JSON``. The documents are stored in collections.
+
+      .. include:: /includes/insert_one.rst
+      .. include:: /includes/driver-example-insert-1.rst
+
+      Unlike SQL tables, MongoDB collections have dynamic schemas. That is,
+      a single collection can store documents that differ in shapes (i.e.
+      contain different fields and value types). And unlike SQL, no DDL
+      operation is required to add or remove fields or modify field types.
+      You just update the documents directly.
+
+      .. note::
+    
+         While MongoDB does support dynamic collection definitions, you can
+         also enforce a uniform schema for the documents in your collection.
+         See :ref:`JSON Schema validation <schema-validation-json>`.
+
+      .. include:: /includes/drivers_close_connection.rst
+
+
+Summary
+-------
+
+If you have successfully completed this guide, you have created your first MongoDB data.
+In the next guide, you will check your work by retrieving the information you just saved.
+
+What's Next
+-----------
+
+In this guide, you will read all documents from a collection in the MongoDB database.
+
+- :doc:`Read Data from MongoDB </server/read>`
+
+See Also
+--------
+
+For other CRUD guides:
+
+- :doc:`/server/read`
+- :doc:`/server/read_operators`
+- :doc:`/server/read_queries`
+- :doc:`/server/update`
+- :doc:`/server/delete`
+
+.. guide-next::

source/includes/driver-example-insert-1.rst

@@ -20,7 +20,7 @@
 
      - id: python
        content: |
-         .. literalinclude:: /driver-examples/test_examples.py
+         .. literalinclude:: /includes/examples/curl_examples/test_examples.py
             :language: python
             :dedent: 8
             :start-after: Start Example 1
@@ -29,15 +29,15 @@
 
      - id: go
        content: |
-         .. literalinclude:: /driver-examples/examples.go
+         .. literalinclude:: /includes/examples/curl_examples/examples.go
             :language: go
             :dedent: 2
             :start-after: Start Example 1
             :end-before: End Example 1
 
      - id: motor
        content: |
-         .. literalinclude:: /driver-examples/test_examples_motor.py
+         .. literalinclude:: /includes/examples/curl_examples/test_examples_motor.py
             :language: python
             :dedent: 8
             :start-after: Start Example 1
@@ -65,23 +65,23 @@
          Next, populate a Document with fields and an embedded document,
          and insert it into the database.
 
-         .. literalinclude:: /driver-examples/DocumentationSamples.java
+         .. literalinclude:: /includes/examples/curl_examples/DocumentationSamples.java
             :language: java
             :dedent: 8
             :start-after: Start Example 1
             :end-before: End Example 1
 
      #- id: java-async
      #  content: |
-     #    .. literalinclude:: /driver-examples/AsyncDocumentationSamples.java
+     #    .. literalinclude:: /includes/examples/curl_examples/AsyncDocumentationSamples.java
      #       :language: java
      #       :dedent: 8
      #       :start-after: Start Example 1
      #       :end-before: End Example 1
 
      - id: nodejs
        content: |   
-         .. literalinclude:: /driver-examples/examples_tests.js
+         .. literalinclude:: /includes/examples/curl_examples/examples_tests.js
             :language: javascript
             :dedent: 8
             :start-after: Start Example 1
@@ -90,39 +90,39 @@
 
      - id: csharp
        content: |
-         .. literalinclude:: /driver-examples/DocumentationExamples.cs
+         .. literalinclude:: /includes/examples/curl_examples/DocumentationExamples.cs
             :language: c#
             :dedent: 12
             :start-after: Start Example 1
             :end-before: End Example 1
 
      # - id: php
      #   content: |
-     #     .. literalinclude:: /driver-examples/DocumentationExamplesTest.php
+     #     .. literalinclude:: /includes/examples/curl_examples/DocumentationExamplesTest.php
      #        :language: php
      #        :dedent: 8
      #        :start-after: Start Example 1
      #        :end-before: End Example 1
      # 
      # - id: perl
      #   content: |
-     #     .. literalinclude:: /driver-examples/driver-examples.t
+     #     .. literalinclude:: /includes/examples/curl_examples/driver-examples.t
      #        :language: perl
      #        :dedent: 4
      #        :start-after: Start Example 1
      #        :end-before: End Example 1
      # 
      # - id: ruby
      #   content: |
-     #     .. literalinclude:: /driver-examples/shell_examples_spec.rb
+     #     .. literalinclude:: /includes/examples/curl_examples/shell_examples_spec.rb
      #        :language: ruby
      #        :dedent: 6
      #        :start-after: Start Example 1
      #        :end-before: End Example 1
      # 
      # - id: scala
      #   content: |
-     #     .. literalinclude:: /driver-examples/DocumentationExampleSpec.scala
+     #     .. literalinclude:: /includes/examples/curl_examples/DocumentationExampleSpec.scala
      #        :language: scala
      #        :dedent: 4
      #        :start-after: Start Example 1

source/includes/drivers_connect.rst

@@ -84,7 +84,7 @@
 
          Later you'll configure the context specific to your requirements.
 
-         .. literalinclude:: /driver-examples/connect.go
+         .. literalinclude:: /includes/examples/go/connect.go
             :language: go
             :dedent: 1 
             :start-after: Open Connection