DOCS-853 toArray method

Author: kay-kim

source/core/read-operations.txt

@@ -732,23 +732,25 @@ information on cursor methods.
 Iterator Index
 ~~~~~~~~~~~~~~
 
-In the :program:`mongo` shell, you can use the ``toArray()`` method to
-iterate the cursor and return the documents in an array, as in the
-following:
+In the :program:`mongo` shell, you can use the :method:`toArray()
+<cursor.toArray()>` method to iterate the cursor and return the
+documents in an array, as in the following:
 
 .. code-block:: javascript
 
    var myCursor = db.inventory.find( { type: 'food' } );
    var documentArray = myCursor.toArray();
    var myDocument = documentArray[3];
 
-The ``toArray()`` method loads into RAM all documents returned by the
-cursor; the ``toArray()`` method exhausts the cursor.
+The :method:`toArray() <cursor.toArray()>` method loads into RAM all
+documents returned by the cursor; the :method:`toArray()
+<cursor.toArray()>` method exhausts the cursor.
 
 Additionally, some :doc:`drivers </applications/drivers>` provide
 access to the documents by using an index on the cursor (i.e.
 ``cursor[index]``). This is a shortcut for first calling the
-``toArray()`` method and then using an index on the resulting array.
+:method:`toArray() <cursor.toArray()>` method and then using an index
+on the resulting array.
 
 Consider the following example:
 

source/reference/method/cursor.toArray.txt

@@ -0,0 +1,28 @@
+================
+cursor.toArray()
+================
+
+.. default-domain:: mongodb
+
+.. method:: cursor.toArray()
+
+   The :method:`toArray() <cursor.toArray()>` method iterates a cursor
+   completely to retrieve the documents and return these documents in
+   an array. The :method:`toArray() <cursor.toArray()>` method loads
+   into RAM all documents returned by the cursor and exhausts the
+   cursor.
+
+   :returns: An array of documents.
+
+Consider the following example that applies :method:`toArray()
+<cursor.toArray()>` to the cursor returned from the :method:`find()
+<db.collection.find()>` method:
+
+.. code-block:: javascript
+
+   var docArray = db.products.find().toArray();
+
+   if (docArray.length > 0) { printjson (docArray[0]); }
+
+The variable ``docArray`` holds the array of documents returned by
+:method:`toArray() <cursor.toArray()>`.