Merge pull request #49 from terakilobyte/DOCSP-9556

Docsp 9556

Author: terakilobyte

snooty.toml

@@ -1,6 +1,6 @@
 name = "java"
 title = "Java"
-toc_landing_pages = ["/fundamentals/connection"]
+toc_landing_pages = ["/fundamentals/connection", "/fundamentals/crud"]
 
 [constants]
 version = 4.0

source/fundamentals/crud.txt

@@ -1,13 +1,24 @@
-
-====
-CRUD
-====
+===============
+CRUD Operations
+===============
 
 .. default-domain:: mongodb
 
 .. toctree::
-   :titlesonly:
-   :maxdepth: 1
+   :caption: CRUD Operations
+
+   /fundamentals/crud/read-operations
+   /fundamentals/crud/write-operations
+
+CRUD (Create, Read, Update, Delete) operations enable you to work with
+data stored in MongoDB.
+
+- :doc:`Read Operations </fundamentals/crud/read-operations>` find and return
+  documents stored in your database.
+- :doc:`Write Operations </fundamentals/crud/write-operations>` insert, modify,
+  or delete documents in your database.
 
-   /fundamentals/crud/read
-   
+..
+  Some operations combine aspects of read and write operations. See our
+  guide on :doc:`compound operations </fundamentals/crud/compound-operations>`
+  to learn more about these hybrid methods.

source/fundamentals/crud/read-operations.txt

@@ -0,0 +1,30 @@
+===============
+Read Operations
+===============
+
+.. default-domain:: mongodb
+
+- :doc:`/fundamentals/crud/read-operations/cursor`
+- :doc:`/fundamentals/crud/read-operations/sort`
+- :doc:`/fundamentals/crud/read-operations/limit`
+
+..
+  - :doc:`/fundamentals/crud/read-operations/retrieve`
+  - :doc:`/fundamentals/crud/read-operations/skip`
+  - :doc:`/fundamentals/crud/read-operations/project`
+  - :doc:`/fundamentals/crud/read-operations/geo`
+  - :doc:`/fundamentals/crud/read-operations/text`
+
+.. toctree::
+   :caption: Read Operations
+
+   /fundamentals/crud/read-operations/cursor
+   /fundamentals/crud/read-operations/sort
+   /fundamentals/crud/read-operations/limit
+..
+  /fundamentals/crud/read-operations/skip
+  /fundamentals/crud/read-operations/retrieve
+  /fundamentals/crud/read-operations/project
+  /fundamentals/crud/read-operations/geo
+  /fundamentals/crud/read-operations/text
+

source/fundamentals/crud/read-operations/cursor.txt

@@ -0,0 +1,8 @@
+=========================
+Access Data From a Cursor
+=========================
+
+.. default-domain:: mongodb
+
+Read operations that return multiple documents do not immediately return
+all values matching the query.

source/fundamentals/crud/read/limit.txt renamed to source/fundamentals/crud/read-operations/limit.txt

@@ -4,17 +4,17 @@ Limit the Number of Returned Results
 
 .. default-domain:: mongodb
 
-Use ``limit()`` to cap the number of documents that a read operation returns. 
+Use ``limit()`` to cap the number of documents that a read operation returns.
 This instance method designates the maximum number of
 documents that a read operation can return. If there are not enough documents
-to reach the specified limit, it can return a smaller number. 
+to reach the specified limit, it can return a smaller number.
 If you use ``limit()`` with the ``skip()`` (TODO: link) instance method, the skip applies
 first and the limit only applies to the documents left over after
 the skip.
 
 The examples below demonstrate, respectively, how to insert data into
 a collection, how to use ``limit()`` to restrict the number of returned documents,
-and how to combine ``limit()`` with ``skip()`` to further narrow the results returned from a query. 
+and how to combine ``limit()`` with ``skip()`` to further narrow the results returned from a query.
 
 The following operation inserts documents representing books into a collection:
 
@@ -57,7 +57,7 @@ books with shorter lengths. Lastly, it limits the return value to ``3`` document
         while (cursor.hasNext()) {
             System.out.println(cursor.next());
         }
-    } 
+    }
     // close the cursor
     finally {
         cursor.close();
@@ -85,7 +85,7 @@ length:
       collection.find().limit(3).sort(descending("length"));
 
 
-To see the next three longest books, append the ``skip()`` method to your 
+To see the next three longest books, append the ``skip()`` method to your
 ``find()`` call. The integer argument passed to ``skip()`` will determine
 how many documents the find operation returns:
 
@@ -119,8 +119,8 @@ collection, returning only small subsets of the collection at one time.
 
   For example, consider the following data:
 
-  .. code_block:: java
-      
+  .. code-block:: java
+
       { type: "computer", data: "1", serial_no: 235235 }
       { type: "computer", data: "2", serial_no: 235237 }
       { type: "computer", data: "3", serial_no: 235239 }

source/fundamentals/crud/sort.txt renamed to source/fundamentals/crud/read-operations/sort.txt

@@ -0,0 +1,24 @@
+================
+Write Operations
+================
+
+.. default-domain:: mongodb
+
+- :doc:`/fundamentals/crud/write-operations/insert`
+- :doc:`/fundamentals/crud/write-operations/upsert`
+
+..
+  - :doc:`/fundamentals/crud/write-operations/delete`
+  - :doc:`/fundamentals/crud/write-operations/change-a-document`
+  - :doc:`/fundamentals/crud/write-operations/embedded-arrays`
+
+.. toctree::
+   :caption: Write Operations
+
+   /fundamentals/crud/write-operations/insert
+   /fundamentals/crud/write-operations/upsert
+
+..
+  /fundamentals/crud/write-operations/delete
+  /fundamentals/crud/write-operations/change-a-document
+  /fundamentals/crud/write-operations/embedded-arrays