Added changes

Author: dfreniche

docs/1-mongodb-atlas/15-prerequisites.mdx

@@ -1,7 +1,7 @@
-# Import a Library data
+# Import Library data
 
 We'll import a library dataset, with Author, Book and reviews information.
 
-- copy the [Connection String](https://www.mongodb.com/docs/manual/reference/connection-string/) from your MongoDB cluster
+- 💻 copy the [Connection String](https://www.mongodb.com/docs/manual/reference/connection-string/) from your MongoDB cluster
 - make sure to grant network access from everywhere
-- go to https://library-scripts-ofiejy7uia-uc.a.run.app/, run the import
+- 💻 go to https://library-scripts-ofiejy7uia-uc.a.run.app/, run the import

docs/1-mongodb-atlas/get-started-atlas.mdx

@@ -18,25 +18,15 @@ Next, deploy your forever-free cloud database in MongoDB Atlas.
 
 1. Click on the **Build a Database** button.
 
-    <img
-        alt="'Create a database' section in MongoDB Atlas highlighting the 'Build a database' button" 
-        src={useBaseUrl('/img/chapter-1-mongodb-atlas/create-a-database.png')}
-        width="500"
-    />
+    <Screenshot src="/img/chapter-1-mongodb-atlas/create-a-database.png" url="https://cloud.atlas.com" alt="'Create a database' section in MongoDB Atlas highlighting the 'Build a database' button" />
 
 1. Select **M0** — the free shared tier.
 
-    <img
-        alt="Database type selection section highlighting the M0 option"
-        src={useBaseUrl('/img/chapter-1-mongodb-atlas/select-database-type.png')}
-    />
+    <Screenshot src="/img/chapter-1-mongodb-atlas/select-database-type.png" url="https://cloud.atlas.com" alt="Database type selection section highlighting the M0 option" />
 
 1. Select a cloud provider and a region close to you. Rename your database to **AtlasSearchSoccer**.
 
-    <img
-        alt="Configuration settings for cloud provider, region and database name"
-        src={useBaseUrl('/img/chapter-1-mongodb-atlas/select-cloud-provider-region-name.png')}
-    />
+    <Screenshot src="/img/chapter-1-mongodb-atlas/select-cloud-provider-region-name.png" url="https://cloud.atlas.com" alt="Configuration settings for cloud provider, region and database name" />
 
 1. Click **Create** to deploy your database.
 

docs/30-simple-queries/3-project.mdx

@@ -6,78 +6,81 @@ A document from the `books` collection looks like:
 
 ```js
 {
-  _id: '0452264464',
-  title: 'Beloved (Plume Contemporary Fiction)',
+  _id: '0765342502',
+  title: 'The Green Brain',
   authors: [
     {
-      _id: '64cc2db4830ba29148da4c4e',
-      name: 'Toni Morrison'
+      _id: '64cc2db4830ba29148da52be',
+      name: 'Frank Herbert'
     }
   ],
-  pages: 288,
-  year: 1998,
-  cover: 'https://images.isbndb.com/covers/44/65/9780452264465.jpg',
+  pages: 224,
+  year: 2002,
+  synopsis: 'a Fascinating Examination Of The Fragile Balance Between Consciousness, Man, And Insect From One Of The Best-loved Science Fiction Creators Of All Time.',
+  cover: 'https://images.isbndb.com/covers/25/08/9780765342508.jpg',
   attributes: [
-    {
-      key: 'publisher',
-      value: 'Longman'
-    },
-    {
-      key: 'language',
-      value: 'en'
-    },
-    {
-      key: 'image',
-      value: 'https://images.isbndb.com/covers/44/65/9780452264465.jpg'
-    },
-    {
-      key: 'title_long',
-      value: 'Beloved (Plume Contemporary Fiction)'
-    },
     {
       key: 'edition',
-      value: 'Reissue'
+      value: '1st'
     },
     {
       key: 'dimensions',
-      value: 'Height: 8 Inches, Length: 5.46 Inches, Weight: 0.57981574906 Pounds, Width: 0.67 Inches'
-    },
-    {
-      key: 'date_published',
-      value: '1998'
+      value: 'Height: 1.111 Inches, Length: 1.111 Inches, Weight: 0.2 Pounds, Width: 1.111 Inches'
     },
     {
       key: 'isbn13',
-      value: '9780452264465'
+      value: '9780765342508'
     },
     {
       key: 'msrp',
-      value: 6.67
-    },
-    {
-      key: 'binding',
-      value: 'Paperback'
+      value: 6.99
     },
     {
       key: 'isbn',
-      value: '0452264464'
+      value: '0765342502'
     },
     {
       key: 'isbn10',
-      value: '0452264464'
+      value: '0765342502'
+    }
+  ],
+  totalInventory: 1,
+  available: 1,
+  binding: 'Mass Market Paperback',
+  language: 'en',
+  longTitle: 'The Green Brain',
+  publisher: 'Tor Books',
+  reviews: [
+    {
+      text: 'I absolutely loved this book! The characters were well-developed and the plot was gripping. The writing style was engaging and kept me hooked until the very end. Highly recommend!',
+      rating: 4,
+      name: 'Phoebe Silva',
+      timestamp: 2023-03-30T11:56:44.519Z,
+      _id: ObjectId("6511eb21ace76077e045b2d7")
+    },
+    {
+      text: 'I really enjoyed this book. The story kept me engaged from beginning to end and the characters were well-developed. The writing style was captivating and the plot had several unexpected twists and turns. Overall, a great read that I would highly recommend!',
+      rating: 4,
+      name: 'عرشيا کوتی',
+      timestamp: 2022-05-30T15:15:43.377Z,
+      _id: ObjectId("6511eb20ace76077e045b2d5")
     },
     {
-      key: 'other_isbns',
-      value: [
-        {
-          isbn: '9780307794802',
-          binding: 'print'
-        }
-      ]
+      text: "This book is an absolute masterpiece. The storytelling is captivating and the characters are so well-developed. I couldn't put it down and found myself fully immersed in the story from beginning to end. The writing style is beautiful and the plot twists kept me on the edge of my seat. I highly recommend this book to anyone who enjoys a thought-provoking and emotionally charged read. It's truly a gem!",
+      rating: 5,
+      name: 'Malo Lecomte',
+      timestamp: 2021-08-27T20:34:33.710Z,
+      _id: ObjectId("6511eb21ace76077e045b2d6")
     }
   ],
-  totalInventory: 2,
-  available: 2
+  vectorizedSynopsis: [
+    0.020951554,
+    0.001816311,
+    0.00775048,
+    -0.01312131,
+    0.01894414,
+    0.006397802,
+    -0.027944269,
 }
 ```
 

docs/30-simple-queries/6-writing-long-pipelines.mdx

@@ -28,8 +28,16 @@ db.books.aggregate([
 
 Easier to read, and reason about, right?
 
+💻 Try to run the above pipeline and compare your results: should be the same
+
 :::tip
 
 Write your aggregation pipelines like you'll compose functions in your programming language. Aggregations _are_ code that runs on the server. In the client you just express _what_ you want to be done, not _how_ to do it.
 
+:::
+
+:::tip
+
+As this is code, we can even add comments (starting with `//`) to our pipelines
+
 :::

docs/30-simple-queries/7-repeating-stages.mdx

@@ -14,3 +14,22 @@ So we can repeat most stages, and do something like this to get all books from 2
 ```js
 db.books.aggregate([{$match: {pages: 100}}, {$match: {year: 2011}}])
 ```
+
+
+
+💻 Add several `$limt` stages at the end of the above aggregation, limiting to 1 book and see what happens
+
+<details>
+<summary>Answer</summary>
+<div>
+
+```js
+db.books.aggregate([
+    {$match: {pages: 100}}, 
+    {$match: {year: 2011}},
+    {$limit: 1},
+    {$limit: 1},
+])
+```
+</div>
+</details>

docs/40-counting-sorting/1-counting-documents.mdx

@@ -38,6 +38,19 @@ Here, `$count` will count the resulting docs and will return a document with jus
 }
 ```
 
+
+💻 How many authors do we have in our `authors` collection?
+
+<details>
+<summary>Answer</summary>
+<div>
+
+```js
+db.authors.aggregate([{$count: "authorCount"}])
+```
+</div>
+</details>
+
 ## The order of stages is important
 
 If we count after the `$match` stage, the document we're passing to the next steps contains only the `totalBooks` field. So the `$project` will return an empty document.

docs/40-counting-sorting/10-sorting.mdx

@@ -1,6 +1,6 @@
 # Sorting
 
-We can sort our results using the `$sort` stage:
+We can sort our results using the `$sort` stage. We need to sort on a field, being 1 ascending and -1 descending order.
 
 Let's get all books from 1984, sorted by number of pages. We'll only show the title, pages and authors.