Add "CRUD operations" and "Understanding FerretDB" sections

website/docs/Basic_operations/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "Basic CRUD Operations",
+  "position": 4,
+  "link": {
+    "type": "generated-index",
+    "description": "Perform basic CRUD operations using FerretDB."
+  }
+}

website/docs/Basic_operations/create.md

@@ -0,0 +1,80 @@
+---
+sidebar_position: 2
+---
+
+# Insert operation
+
+The insert operation adds a new document to a collection.
+
+## Insert a single document
+
+The `insertOne()` command is used to add a single document into a collection, using this syntax format:
+
+```sh
+db.collection.insertOne({field1: value1, field2: value2,.... fieldN: valueN})
+```
+
+The example below depicts how a single document can be added to a collection.
+If a collection does not exist, the insert command automatically creates one.
+
+```sh
+db.scientists.insertOne({
+    name: {
+        firstname: "Thomas",
+        lastname: "Edison"
+    },
+    born: 1847,
+    invention: "lightbulb"
+})
+```
+
+If the operation is successful, you will get a response with acknowledged set to true, and the autogenerated ObjectId of the document that looks like this:
+
+```sh
+{
+  acknowledged: true,
+  insertedId: ObjectId("6346fcafd7a4a1b0b38eb2db")
+}
+```
+
+## Insert multiple documents at once
+
+A collection can contain multiple documents.
+Using the `insertMany()` command, you can add multiple documents to a collection at once.
+
+```sh
+db.collection_name.insertMany([{document1}, {document2},... {documentN}])
+```
+
+The following example shows how to insert multiple documents into a collection:
+
+```sh
+db.scientists.insertMany([
+    {
+        name: {
+        firstname: "Alan",
+        lastname: "Turing"
+        },
+        born: 1912,
+        invention: "Turing Machine"
+    },
+    {
+        name: {
+        firstname: "Graham",
+        lastname: "Bell"
+        },
+        born: 1847,
+        invention: "telephone"
+    },
+    {
+        name: {
+        firstname: "Ada",
+        lastname: "Lovelace"
+        },
+        born: 1815,
+        invention: "computer programming"
+    }
+])
+```
+
+You can retrieve all the documents in the collection with this command: `db.scientists.find({})`

website/docs/Basic_operations/delete.md

@@ -0,0 +1,89 @@
+---
+sidebar_position: 5
+---
+
+
+# Delete operation
+
+The delete operation removes a document from the database when a given query is met.
+Two methods for deleting documents in a collection include `deleteOne()` and `deleteMany()`.
+
+## Delete a single document
+
+The `deleteOne()` method removes a single document (the first document that matches the query parameter) completely from the collection.
+
+```sh
+db.collection.deleteOne({<query_params>})
+```
+
+Insert the following list of documents:
+
+```sh
+db.scientists.insertMany([
+  {
+    firstname: "Thomas",
+    lastname: "Edison",
+    born: 1847,
+    invention: "LightBulb",
+    nobel: true
+  },
+  {
+    firstname: "Graham",
+    lastname: "Bell",
+    born: 1847,
+    invention: "telephone",
+    nobel: false
+  },
+  {
+    firstname: "Nikola",
+    lastname: "Tesla",
+    born: 1856,
+    invention: "Tesla coil",
+    nobel: false
+  },
+  {
+    firstname: "Ada",
+    lastname: "Lovelace",
+    born: 1815,
+    invention: "Computer programming",
+    nobel: false
+  }
+])
+```
+
+This operation returns a response showing `acknowledged` as `true` and the `ObjectId` of the four inserted documents:
+
+```sh
+{
+  acknowledged: true,
+  insertedIds: {
+    '0': ObjectId("63470121d7a4a1b0b38eb2df"),
+    '1': ObjectId("63470121d7a4a1b0b38eb2e0"),
+    '2': ObjectId("63470121d7a4a1b0b38eb2e1"),
+    '3': ObjectId("63470121d7a4a1b0b38eb2e2")
+  }
+}
+```
+
+Next, delete a document from the collection where the field `nobel` is set to false.
+
+```sh
+db.scientists.deleteOne({nobel:false})
+```
+
+This operation returns a response that shows that a single document was deleted from the collection.
+
+```sh
+{ acknowledged: true, deletedCount: 1 }
+```
+
+## Deletes multiple documents
+
+To delete multiple documents at once, use the  `deleteMany()` method.
+Using the same record from earlier, let's delete all the documents with `nobel` set to false.
+
+```sh
+db.scientists.deleteMany({nobel:false})
+```
+
+This command removes all the documents in the collection that matches the query.

website/docs/Basic_operations/index.md

@@ -0,0 +1,44 @@
+---
+sidebar_position: 1
+---
+
+
+
+# Performing CRUD operations
+
+CRUD (Create, Read, Update, and Delete) operations in FerretDB uses the same protocols and drivers as MongoDB.
+
+## Create operations in FerretDB
+
+The create operation adds a new document to a collection.
+If the collection does not exist, this operation will create it.
+The following methods are available for adding documents to a collection:
+
+[`db.collection.insertOne()`](./create.md#insert-a-single-document), [`db.collection.insertMany()`](./create.md#insert-many-documents-at-once)
+
+## Read operations in FerretDB
+
+The read operation retrieves document records in a collection.
+You can also filter the documents by targeting specific criteria for retrieval.
+The following commands are used to retrieve documents from a collection:
+
+[`db.collection.find()`](./read.md#retrieve-all-documents-in-a-collection), [`db.collection.findOne()`](./read.md#retrieve-a-single-document)
+
+The read operation can also retrieve subdocuments that are nested within a document.
+
+## Update operations in FerretDB
+
+The update operation modifies document records in a collection.
+It changes existing documents in a collection according to the query criteria.
+The following update operations are supported:
+
+[`db.collection.updateOne()`](./update.md#modify-a-single-document), [`db.collection.updateMany()`](./update.md#modify-many-documents), [`db.collection.replaceOne()`](./update.md#replace-a-document)
+
+## Delete operations in FerretDB
+
+The delete operation removes document records from a collection.
+The following delete operations are supported:
+
+[`db.collection.deleteOne()`](./delete.md#delete-a-single-document), [`db.collection.deleteMany()`](./delete.md#deletes-multiple-documents)
+
+Similar to the update operation, this operation retrieves documents matching specific criteria in a collection and deletes them.

website/docs/Basic_operations/read.md

@@ -0,0 +1,94 @@
+---
+sidebar_position: 3
+---
+
+# Read operation
+
+The read operation retrieves documents in a collection.
+You can either retrieve all the documents in a collection, or only the documents that match a given query parameter.
+
+## Retrieve all documents in a collection
+
+The `find()` command is used for retrieveing all the documents in a collection.
+
+```sh
+db.collection.find()
+```
+
+First, populate the database with a new collection containing a list of documents.
+
+```sh
+db.scientists.insertMany([
+  {
+    name: {
+      firstname: "Alan",
+      lastname: "Turing"
+    },
+    born: 1912,
+    invention: "Turing Machine"
+  },
+  {
+    name: {
+      firstname: "Graham",
+      lastname: "Bell"
+    },
+    born: 1847,
+    invention: "telephone"
+  },
+  {
+    name: {
+      firstname: "Ada",
+      lastname: "Lovelace"
+    },
+    born: 1815,
+    invention: "computer programming"
+  }
+])
+```
+
+Run `db.scientists.find()` to see the complete list of documents in the collection.
+
+### Retrieve documents based on a specific query
+
+Using the `find()` command, you can also filter a collection for only the documents that match the provided query.
+For example, find the document with the field `born` set as 1857.
+
+```sh
+db.scientists.find({born: 1857})
+```
+
+### Retrieve documents using operator queries
+
+The operator syntax allows users to query and retrieve a document.
+There are several operator methods that you can use, such as `$gt` or `$lt`.
+For example, to find the list of scientists born after the 1900s, we'll need the `$gt` operator:
+
+```sh
+db.scientists.find({born:{$gt:1900}})
+```
+
+Here is a list of the most commonly used operators.
+
+`$gt`: selects records that are greater than a specific value
+
+`$lt`:  selects records that are less than a specific value
+
+`$gte`: selects records greater or equal to a specific value
+
+`$lte`: selects records less than or equal to a specific value
+
+`$in`: selects any record that contains any of the items present in a defined array
+
+`$nin`: selects any record that does not contain any of the items in a defined array
+
+`$ne`: selects records that are not equal to a specific value
+
+`$eq`: select records that are equal to a specific value
+
+## Retrieve a single document
+
+The `findOne()` command retrieves a single document from a collection.
+
+```sh
+db.scientists.findOne({invention: "Turing Machine"})
+```