Merge branch 'main' into patch-1

Author: sourabhbagrecha

README.md

@@ -1,19 +1,3 @@
-# Docusaurus Template Workshop
+# SQL to MongoDB Query API
 
-This is a template to __create new Lab documentation sites__. Contains info on how to use Docusaurus and is a good starting point.
-
-### Installation, use, how to build, etc.
-
-Everything is covered in the Lab itself: https://mongodb-developer.github.io/docusaurus-workshop/
-
-## Contributing
-
-As `main` is protected, submit a pull request to be reviewed.
-
-## Docusaurus
-
-This website is built using [Docusaurus 2](https://docusaurus.io/), a modern static website generator. It's available on https://mongodb-developer.github.io/docusaurus-workshop/.
-
-### Disclaimer
-
-Use at your own risk; not a supported MongoDB product
+Workshop Docs hosted at: https://sql-to-query-api-lab.github.io/sql-to-query-api-lab/docs/category/prerequisites

docs/20-prerequisites/20-prerequisite.mdx

@@ -6,7 +6,8 @@ description: Setting up your MongoDB Atlas account, importing Library data
 
 To follow along, you'll need to complete the first two labs of the MongoDB for RDBMS professionals, which will help you in getting:
 
-- A MongoDB Atlas cluster.
-- Test data. In this case, this is book, author, and review data for a library management system.
 
-👐 To get both, open the [intro lab](https://mongodb-developer.github.io/intro-lab/docs/intro) and follow it (only takes 10-15 mins) to get your database ready. Return here when finished!
+- A free MongoDB Atlas Cluster
+- Sample library data
+
+To get both, open the [intro lab](https://mongodb-developer.github.io/intro-lab/docs/intro) and follow it (only takes 10-15 mins) to get your database ready. Return here when finished!

docs/30-quick-start.mdx

@@ -1,15 +1,33 @@
 # 👐 Quick Start
 
-For the impatient AKA all of us
+For the impatient, AKA all of us:
 
 ## Install Compass
 
-To use work through the exercises, we need to install the official MongoDB GUI: [Download and Install Compass](https://www.mongodb.com/try/download/compass)
+To use work through the exercises, we need to install the official MongoDB GUI. [Download and install Compass](https://www.mongodb.com/try/download/compass).
 
-## Connect compass to your Atlas cluster
+## Connect Compass to your Atlas cluster
 
-- Insert Add connection page of compass
+### 1. Click on the "Add connection" button on the home page
 
-## Select the library database
+![](/img/add-connection-compass.png)
 
-- Insert databases list
+### 2. Paste your connection string after updating your password and click on the "Save and Connect" button
+
+![](/img/enter-connection-uri-compass.png)
+
+### 3. Select the library database
+
+![](/img/select-db-collection-compass.png)
+
+### 4. Click on the "Open MongoDB shell" button
+
+![](/img/open-shell-compass.png)
+
+### 5. Switch to the library database in the shell
+
+Once the shell is loaded, execute: `use library` to ensure you are in the correct database.
+
+![](/img/use-library-compass.png)
+
+That's it for the setup, let's get our hands dirty!

docs/40-CRUD/1-WHERE.mdx

@@ -1,22 +1,22 @@
 # 👐 WHERE → .find()
 
-Similar to SQL's `WHERE` clause, the `.find()` method in MongoDB retrieves documents from a collection that match a specified query.
+Similar to SQL's `WHERE` clause, the `.find()` method in MongoDB retrieves documents from a collection that matches a specified query.
 
 ## Syntax
 
 ```js
 db.collection.find({ <query> })
 ```
 
-- `<query>`: Specifies conditions to filter documents.
+- `<query>`: Specifies conditions to filter documents
 
 ## Example: Find all books from 2020
 
 ```js
 db.books.find({ year: 2020 });
 ```
 
-### Equivalent SQL Query
+### Equivalent SQL query
 
 ```sql
 SELECT * FROM books WHERE year = 2020;
@@ -26,24 +26,24 @@ SELECT * FROM books WHERE year = 2020;
 
 The `find()` method takes a document as its first argument. This document specifies the filter criteria. You can use a variety of expressions within the filter document:
 
-- **Comparison Operators:** `$eq` (equals), `$ne` (not equals), `$gt` (greater than), `$lt` (less than), `$gte` (greater than or equals), `$lte` (less than or equals), `$in` (in an array), `$nin` (not in an array).
-- **Logical Operators:** `$and`, `$or`, `$not`.
-- **Element Operators:** `$exists` (check for field existence), `$type` (check data type).
-- **Evaluation Operators:** `$regex` (regular expression matching), `$where` (JavaScript code execution).
-- **Geo-spatial Operators:** For location-based queries.
-- **Array Operators:** For querying arrays.
+- **Comparison operators:** `$eq` (equals), `$ne` (not equals), `$gt` (greater than), `$lt` (less than), `$gte` (greater than or equals), `$lte` (less than or equals), `$in` (in an array), `$nin` (not in an array)
+- **Logical operators:** `$and`, `$or`, `$not`
+- **Element operators:** `$exists` (check for field existence), `$type` (check data type)
+- **Evaluation operators:** `$regex` (regular expression matching), `$where` (JavaScript code execution)
+- **Geo-spatial operators:** For location-based queries
+- **Array operators:** For querying arrays
 
 Now, let's utilize a few MongoDB operators and create more sophisticated queries:
 
-### $or and $gt operator
+### $or and $gt operators
 
-Suppose, we want to get all the books written in 2010 OR has more than 200 pages.
+Suppose we want to get all the books written in 2010 OR books that have more than 200 pages.
 
 ```sql
   SELECT * FROM books WHERE year = 2010 OR pages > 200
 ```
 
-Equivalent MongoDB Query:
+Equivalent MongoDB query:
 
 ```js
 db.books.find({
@@ -56,7 +56,7 @@ db.books.find({
 
 ### $and operator
 
-This time, instead of OR let's query using AND:
+This time, instead of OR, let's query using AND:
 
 ```sql
   SELECT * FROM books WHERE year = 2010 AND pages > 200
@@ -75,17 +75,17 @@ db.books.find({
 
 ### Shorthand $and
 
-When we are querying on 2 different fields and want to utilize $and, we can do so by passing a document with all the conditions like this:
+When we are querying on two different fields and want to utilize $and, we can do so by passing a document with all the conditions, like this:
 
 ```js
 db.books.find({ year: 2010, pages: { $gt: 200 } });
 ```
 
-As you can see, we don't have to pass an Array of conditions, MongoDB implicitly considers this as $and.
+As you can see, we don't have to pass an array of conditions. MongoDB implicitly considers this as $and.
 
 ## 👐 Challenge
 
-Now, translate the following into a MongoDB Query.
+Now, translate the following into a MongoDB query.
 
 #### 1. Find all books where `totalInventory` is exactly 5.
 
@@ -109,13 +109,13 @@ Now, translate the following into a MongoDB Query.
   </div>
 </details>
 
-#### 3. Find books in the "Science" genre that has more than 300 pages.
+#### 3. Find books in the "Science" genre that have more than 300 pages.
 
 <details>
   <summary>Answer</summary>
   <div>
     ```js
-      db.books.find({ genre: "Science", pages: {$gt: 300} });
+      db.books.find({ genres: "Science", pages: {$gt: 300} });
     ```
   </div>
 </details>

docs/40-CRUD/2-SELECT.mdx

@@ -8,7 +8,7 @@ In SQL, the `SELECT` statement allows us to specify which columns to retrieve fr
 db.collection.find({ <query> }, { projection })
 ```
 
-## **Projection Basics**
+## **Projection basics**
 
 - By default, MongoDB returns all fields in a document.
 - Use projection to **include (1)** or **exclude (0)** specific fields.
@@ -21,7 +21,7 @@ db.collection.find({ <query> }, { projection })
 db.books.find({}, { title: 1, authors: 1, _id: 0 });
 ```
 
-**Equivalent SQL Query:**
+**Equivalent SQL query:**
 
 ```sql
 SELECT title, authors FROM books;
@@ -40,7 +40,7 @@ Here:
 db.books.find({}, { reviews: 0 });
 ```
 
-**Equivalent SQL Query:**
+**Equivalent SQL query:**
 
 ```sql
 SELECT title, authors, genres, totalInventory, available FROM books;
@@ -52,13 +52,13 @@ Here:
 
 ---
 
-## **Example 3: Using Projection along with a Query**
+## **Example 3: Using projection along with a query**
 
 ```js
 db.books.find({ genres: "Science" }, { title: 1, totalInventory: 1, _id: 0 });
 ```
 
-**Equivalent SQL Query:**
+**Equivalent SQL query:**
 
 ```sql
 SELECT title, totalInventory FROM books WHERE genres='Science';

docs/40-CRUD/3-ORDER-LIMIT.mdx

@@ -10,20 +10,20 @@ In SQL, we use `ORDER BY` to sort query results and `LIMIT` to restrict the numb
 - `{ field: -1 }` → **Descending order** (Z → A, largest to smallest)
 - You can sort by multiple fields, just like SQL.
 
-## **Limiting Results**
+## **Limiting results**
 
 - `.limit(n)` restricts the number of documents returned.
 - Used together with `.sort()`, it helps fetch the **top N** results.
 
 ---
 
-### 1: Top 5 Books with the Highest Inventory
+### 1: Top 5 books with the highest inventory
 
 ```js
 db.books.find().sort({ totalInventory: -1 }).limit(5);
 ```
 
-**Equivalent SQL Query:**
+**Equivalent SQL query:**
 
 ```sql
 SELECT * FROM books ORDER BY totalInventory DESC LIMIT 5;
@@ -33,7 +33,7 @@ This fetches the **5 books with the highest stock**.
 
 ---
 
-### 2: Get the title of top 10 Fiction Books by highest page count
+### 2: Get the title of top 10 fiction books by highest page count
 
 ```js
 db.books
@@ -44,11 +44,11 @@ db.books
 
 :::info
 
-Along with the title, we fetched pages as well to ensure that we are getting the right results.
+Along with the title, we fetched pages, as well, to ensure that we are getting the right results.
 
 :::
 
-**Equivalent SQL Query:**
+**Equivalent SQL query:**
 
 ```sql
 SELECT title, pages FROM books WHERE genres='Fiction' ORDER BY pages DESC LIMIT 10;

docs/40-CRUD/4-INSERT-DELETE.mdx

@@ -2,10 +2,10 @@
 
 MongoDB provides two methods for inserting documents into a collection:
 
-- `.insertOne()`: Inserts a single document.
-- `.insertMany()`: Inserts multiple documents at once.
+- `.insertOne()`: Inserts a single document
+- `.insertMany()`: Inserts multiple documents at once
 
-And just like insert MongoDB provides:
+And just like insert, MongoDB provides:
 
 - `.deleteOne()`: Deletes the first matching document.
 - `.deleteMany()`: Deletes all matching documents.
@@ -21,7 +21,7 @@ db.reviews.insertOne({
 });
 ```
 
-### Equivalent SQL Query
+### Equivalent SQL query
 
 ```sql
 INSERT INTO reviews (text, rating, name, bookId)
@@ -55,7 +55,7 @@ db.reviews.deleteOne({
 });
 ```
 
-### Equivalent SQL Query
+### Equivalent SQL query
 
 ```sql
 DELETE FROM reviews WHERE bookId = '0786222727';

docs/40-CRUD/5-UPDATE.mdx

@@ -15,11 +15,11 @@ db.collection.updateOne(
 )
 ```
 
-- `<query>`: Specifies which document to update.
+- `<query>`: Specifies which document to update
 
 - `<update operation>`: Defines modifications using update operators like $set, $inc, etc.
 
-- `<options>`: (Optional) Allows additional configurations like upsert: true.
+- `<options>`: (Optional) Allows additional configurations like upsert: true
 
 ## Example: Update a book
 
@@ -30,15 +30,15 @@ db.reviews.updateOne(
 );
 ```
 
-### Equivalent SQL Query
+### Equivalent SQL query
 
 ```sql
 UPDATE reviews SET rating = 5 WHERE bookId = '0312979509';
 ```
 
 ## Upsert option
 
-Let's say, we want to update a review in our database from "John" for the book "0312979509" by rating it 5 stars.
+Let's say we want to update a review in our database from "John" for the book "0312979509" by rating it 5 stars.
 
 ```js
 db.reviews.updateOne(
@@ -47,9 +47,9 @@ db.reviews.updateOne(
 );
 ```
 
-Suppose "John" had never posted a review for this book before, the above query won't really do anything.
+Suppose "John" had never posted a review for this book before. The above query won't really do anything.
 In some cases, we may want to store a fresh new review based on the condition and updates mentioned in query.
-To handle such scenarios in MongoDB, we don't have to write additional application code to achieve this, all we have to do is- utilize the `upsert` option.
+To handle such scenarios in MongoDB, we don't have to write additional application code to achieve this. All we have to do is utilize the `upsert` option.
 
 ```js
 db.reviews.updateOne(
@@ -61,7 +61,7 @@ db.reviews.updateOne(
 
 :::info
 
-Executing the above command, will insert a fresh new document in the collection like this:
+Executing the above command will insert a fresh new document in the collection, like this:
 
 ```js
 {

docs/40-CRUD/_category_.json

@@ -1,5 +1,5 @@
 {
-  "label": "👐 CRUD operations",
+  "label": "👐 CRUD Operations",
   "position": 40,
   "link": {
     "type": "generated-index",