Improve Insert CRUD section and exercises

- Added introductory explanations for insert operations
- Added examples using insertOne() and insertMany()
- Improved challenge descriptions and hints
- Added examples of review documents for guidance
- Added MongoDB documentation links with UTM tracking
- Refined wording and examples for better readability

Author: ricardohsmello

java/30_insert.ipynb

@@ -14,15 +14,22 @@
    "metadata": {},
    "source": [
     "# Basic CRUD: Insert\n",
-    "    "
+    "\n",
+    "## What can the `insert` operation do?\n",
+    "\n",
+    "The [`insert`](https://www.mongodb.com/docs/drivers/java/sync/current/crud/insert/?utm_campaign=devrel&utm_source=third-part-content&utm_medium=cta&utm_content=crud-operations-java-workshop&utm_term=ricardo.mello) operations let us add new documents to a MongoDB collection.\n",
+    "\n",
+    "In this section, we will use operations such as `insertOne()` and `insertMany()` to create and store documents in the `books` collection."
    ]
   },
   {
    "cell_type": "markdown",
    "id": "dependent-boundary",
    "metadata": {},
    "source": [
-    "## Startup code"
+    "## Startup code\n",
+    "\n",
+    "This cell imports the MongoDB Java Driver, connects to MongoDB, and initializes the `library` database and `books` collection used in the insert examples."
    ]
   },
   {
@@ -52,6 +59,10 @@
     "\n",
     "import java.util.List;\n",
     "\n",
+    "// Configure SLF4J Simple Logger to suppress MongoDB driver logs in the notebook output.\n",
+    "System.setProperty(\"org.slf4j.simpleLogger.defaultLogLevel\", \"off\");\n",
+    "System.setProperty(\"org.slf4j.simpleLogger.log.org.mongodb.driver\", \"off\");\n",
+    "\n",
     "// Set your connection String\n",
     "String connectionString = \"mongodb://admin:mongodb@localhost:27017/\";\n",
     "\n",
@@ -81,7 +92,9 @@
    "id": "handled-symbol",
    "metadata": {},
    "source": [
-    "### Insert one book"
+    "### Insert one book\n",
+    "\n",
+    "In this example, we create a new `Document` representing a book and use `insertOne()` to add it to the `books` collection."
    ]
   },
   {
@@ -106,7 +119,9 @@
    "id": "worth-windows",
    "metadata": {},
    "source": [
-    "### Read the book we just inserted, using the year"
+    "### Find the inserted document\n",
+    "\n",
+    "In this example, we query the `books` collection to verify that the document inserted with the year `1500` was successfully stored in MongoDB."
    ]
   },
   {
@@ -131,7 +146,11 @@
    "id": "9f6caab3",
    "metadata": {},
    "source": [
-    "### Can you find the same document, but using the `_id` instead? Fix the code below!"
+    "### Find the same document using the `_id`\n",
+    "\n",
+    "Can you find the same document again, but this time using the `_id` field instead of the `year`?\n",
+    "\n",
+    "Fix the code below by adding the correct `ObjectId`."
    ]
   },
   {
@@ -166,7 +185,20 @@
    "source": [
     "### Insert 4 more reviews for bookId \"0786222727\".\n",
     "\n",
-    "[Solution here](https://mongodb-developer.github.io/sql-to-query-api-lab/docs/CRUD/INSERT-DELETE#-1-insert-4-more-reviews-for-bookid-0786222727)"
+    "_Hint: Use `insertMany()` with a `List.of()` containing multiple `Document` objects._\n",
+    "\n",
+    "Example review document:\n",
+    "\n",
+    "```json\n",
+    "{\n",
+    "  \"text\": \"Amazing book!\",\n",
+    "  \"rating\": 5,\n",
+    "  \"name\": \"Ricardo\",\n",
+    "  \"bookId\": \"0786222727\"\n",
+    "}\n",
+    "````\n",
+    "\n",
+    "[Solution here](https://mongodb-developer.github.io/sql-to-query-api-lab/docs/CRUD/INSERT-DELETE#-1-insert-4-more-reviews-for-bookid-0786222727?utm_campaign=devrel&utm_source=third-part-content&utm_medium=cta&utm_content=crud-operations-java-workshop&utm_term=ricardo.mello)"
    ]
   },
   {
@@ -180,8 +212,23 @@
    },
    "outputs": [],
    "source": [
-    "// type your code here\n",
-    " "
+    "// TYPE YOUR CODE HERE\n",
+    "\n",
+    "var reviews = library.getCollection(\"reviews\");\n",
+    "\n",
+    "<REPLACE_WITH_INSERT_OPERATION>;"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "7e9330dd",
+   "metadata": {},
+   "source": [
+    "## Summary\n",
+    "\n",
+    "In this section, we learned how to insert new documents into MongoDB using operations such as `insertOne()` and `insertMany()`.\n",
+    "\n",
+    "We also explored how MongoDB automatically generates `_id` values and how inserted documents can be queried afterward."
    ]
   }
  ],