DOCSP-14047 add note about mongoshell to page

source/faq/fundamentals.txt

@@ -41,35 +41,64 @@ the columns in a relational database table.
 How do I create a database and a collection?
 --------------------------------------------
 
+.. note:: 
+
+   You can enter the commands referenced in this FAQ by using 
+   the :binary:`~bin.mongo` shell. The mongo shell is an 
+   interactive JavaScript interface to MongoDB. You can use the mongo
+   shell to query and update data as well as perform administrative 
+   operations.
+
 If a database does not exist, MongoDB creates the database when you
 first store data for that database.
 
 If a collection does not exist, MongoDB creates the collection when you
-first store data for that collection. [#explicit-creation]_
+first store data for that collection.
 
 As such, you can switch to a non-existent database (``use <dbname>``)
 and perform the following operation:
 
 .. code-block:: javascript
 
-   use myNewDB
+   use myNewDB;
+
+   db.myNewCollection1.insertOne( { x: 1 } );
+   db.myNewCollection2.createIndex( { a: 1 } );
 
-   db.myNewCollection1.insertOne( { x: 1 } )
-   db.myNewCollection2.createIndex( { a: 1 } )
+- The :method:`db.collection.insertOne()` method creates 
+  the collection ``myNewCollection1`` if it does not already exist.
 
-The ``insert`` operation creates both the database ``myNewDB`` and the
-collection ``myNewCollection1`` if they do not already exist.
+- The :method:`db.collection.createIndex()` method creates the index and 
+  the collection ``myNewCollection2`` if it does not already exist. 
 
-The ``createIndex`` operation, which occurs after the ``myNewDB`` has
-been created, creates the index and the collection ``myNewCollection2``
-if the collection does not exist. If ``myNewDb`` did not exist, the
-``createIndex`` operation would have also created the ``myNewDB``.
+- If the ``myNewDb`` database did not exist, either the
+  :method:`db.collection.createIndex()` method or 
+  :method:`db.collection.insertOne()` method would have created
+  the ``myNewDb`` database automatically.
+<<<<<<< HEAD
+
+You can also create a collection explicitly using
+:method:`db.createCollection` method if you want to specify specific
+:ref:`options<create_collection_parameters>`, such as maximum size
+or document validation rules:
+
+.. code-block:: javascript
+
+   use myNewDB;
+
+=======
+
+You can also create a collection explicitly using
+:method:`db.createCollection` method if you want to specify specific
+:ref:`options<create_collection_parameters>`, such as maximum size
+or document validation rules:
+
+.. code-block:: javascript
 
-.. [#explicit-creation]
+   use myNewDB;
 
-   You can also create a collection explicitly using
-   :method:`db.createCollection` if you want to specify specific
-   options, such as maximum size or document validation rules.
+>>>>>>> 275b25d49 (DOCSP-14047 add note about mongoshell to page)
+   db.createCollection("myNewCollection1");
 
 .. _faq-schema-free:
 

source/reference/method/db.createCollection.txt

@@ -54,6 +54,12 @@ Definition
                                     collation: <document>, 
                                     writeConcern: <document>} )
 
+
+   .. _create_collection_parameters:
+
+
+   .. _create_collection_parameters:
+
    The :method:`db.createCollection()` method has the following parameters: