Improve Update CRUD section and examples

- Added introductory explanations for update operations
- Added examples using updateOne(), set(), addToSet(), and currentTimestamp()
- Added upsert examples and explanations
- Improved challenge instructions and hints
- Refined code formatting and variable naming for readability
- Added MongoDB documentation links with UTM tracking

Author: ricardohsmello

java/40_delete.ipynb

@@ -27,7 +27,9 @@
    "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 delete examples."
    ]
   },
   {

java/50_update.ipynb

@@ -13,16 +13,23 @@
    "id": "3b936925-e295-489a-b508-2b99c0160217",
    "metadata": {},
    "source": [
-    "# CRUD: Update\n",
-    "    "
+    "# Basic CRUD: Update\n",
+    "\n",
+    "## What can the `update` operation do?\n",
+    "\n",
+    "The [`update`](https://www.mongodb.com/docs/drivers/java/sync/current/crud/update-documents/?utm_campaign=devrel&utm_source=third-part-content&utm_medium=cta&utm_content=crud-operations-java-workshop&utm_term=ricardo.mello) operations let us modify existing documents in a MongoDB collection.\n",
+    "\n",
+    "In this section, we will use operations such as `updateOne()` and `updateMany()` to update fields in documents from 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 update examples."
    ]
   },
   {
@@ -57,6 +64,10 @@
     "import org.bson.Document;\n",
     "import org.bson.conversions.Bson;\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",
@@ -78,7 +89,10 @@
    "id": "handled-symbol",
    "metadata": {},
    "source": [
-    "## Insert one book"
+    "## Insert one book\n",
+    "\n",
+    "In this example, we insert a new document into the `books` collection.  \n",
+    "We will later update this same document using `updateOne()`."
    ]
   },
   {
@@ -92,8 +106,7 @@
    },
    "outputs": [],
    "source": [
-    "Document elQuijote = new Document();\n",
-    "elQuijote\n",
+    "Document elQuijote = new Document()\n",
     "        .append(\"_id\", \"quijote\")\n",
     "        .append(\"title\", \"El Quijote\")\n",
     "        .append(\"year\", 1501);\n",
@@ -106,7 +119,9 @@
    "id": "9f6caab3",
    "metadata": {},
    "source": [
-    "### Show the inserted book"
+    "### Find inserted book\n",
+    "\n",
+    "Before updating the document, we query the `books` collection to confirm that the `El Quijote` document was successfully inserted."
    ]
   },
   {
@@ -135,15 +150,14 @@
     }
    },
    "source": [
-    "### Update that book"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "50ea627a",
-   "metadata": {},
-   "source": [
-    "Use the 📗 [updateOne](https://www.mongodb.com/docs/drivers/java/sync/current/usage-examples/updateOne/) documentation."
+    "### Update the inserted book\n",
+    "\n",
+    "In this example, we use `updateOne()` to modify the `El Quijote` document.\n",
+    "\n",
+    "The update operation:\n",
+    "- adds a new field called `newField`\n",
+    "- adds `\"Chivalry\"` to the `genres` array\n",
+    "- updates the `lastUpdated` field with the current timestamp"
    ]
   },
   {
@@ -186,7 +200,9 @@
    "id": "737b00e6",
    "metadata": {},
    "source": [
-    "Now check the contents of the book, that has changed!"
+    "### Verify the updated document \n",
+    "\n",
+    "After running the update operation, we query the `books` collection again to confirm that the document was successfully modified."
    ]
   },
   {
@@ -205,20 +221,19 @@
     "System.out.println(\"Book: \" + aBook.toJson());"
    ]
   },
-  {
-   "cell_type": "markdown",
-   "id": "398d39bb",
-   "metadata": {},
-   "source": [
-    "### Upsert"
-   ]
-  },
   {
    "cell_type": "markdown",
    "id": "ba85cf52",
    "metadata": {},
    "source": [
-    "### Delete the book, so it's not there and can't be updated"
+    "## Understanding `upsert`\n",
+    "\n",
+    "[`upsert`](https://www.mongodb.com/docs/drivers/java/sync/current/crud/update-documents/upsert/?utm_campaign=devrel&utm_source=third-part-content&utm_medium=cta&utm_content=crud-operations-java-workshop&utm_term=ricardo.mello) combines **update** and **insert** behavior in a single operation.\n",
+    "\n",
+    "If a matching document exists, MongoDB updates it.  \n",
+    "If no document matches the filter, MongoDB inserts a new one instead.\n",
+    "\n",
+    "To demonstrate this behavior, we first delete the `El Quijote` document so it no longer exists in the collection."
    ]
   },
   {
@@ -244,7 +259,9 @@
    "id": "e5ddfd06",
    "metadata": {},
    "source": [
-    "### Upsert: we try to update it but will get inserted instead"
+    "### Run the update operation with `upsert`\n",
+    "\n",
+    "Now that the document no longer exists in the collection, we run the update operation again with `upsert(true)` enabled."
    ]
   },
   {
@@ -282,6 +299,36 @@
     "}"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "e93a39fc",
+   "metadata": {},
+   "source": [
+    "### Verify the upserted document\n",
+    "\n",
+    "Since the document did not exist, MongoDB inserted a new one during the update operation with `upsert(true)` enabled.\n",
+    "\n",
+    "We can now query the collection again to confirm that the document was created."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "383fd2e3",
+   "metadata": {
+    "vscode": {
+     "languageId": "java"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "Document upsertedBook = books.find(\n",
+    "        new Document(\"_id\", \"quijote\")\n",
+    ").first();\n",
+    "\n",
+    "System.out.println(\"Book: \" + upsertedBook.toJson());"
+   ]
+  },
   {
    "cell_type": "markdown",
    "id": "b8bfa616",
@@ -295,9 +342,11 @@
    "id": "fe70e1e8",
    "metadata": {},
    "source": [
-    "### Update the pages of the book \"Treasure of the Sun\" to 449.\n",
+    "### Update the pages of the book `\"Treasure of the Sun\"` to `449`\n",
     "\n",
-    "[Solution here](https://mongodb-developer.github.io/sql-to-query-api-lab/docs/CRUD/UPDATE#-1-update-the-pages-of-the-book-treasure-of-the-sun-to-449)"
+    "_Hint: Use `updateOne()` together with `Updates.set()` to modify the value of a single field._\n",
+    "\n",
+    "[Solution here](https://mongodb-developer.github.io/sql-to-query-api-lab/docs/CRUD/UPDATE#-1-update-the-pages-of-the-book-treasure-of-the-sun-to-449?utm_campaign=devrel&utm_source=third-part-content&utm_medium=cta&utm_content=crud-operations-java-workshop&utm_term=ricardo.mello)"
    ]
   },
   {
@@ -311,7 +360,26 @@
    },
    "outputs": [],
    "source": [
-    "// type your code here\n"
+    "//TYPE YOUR CODE HERE\n",
+    "\n",
+    "var query = <REPLACE_WITH_QUERY>;\n",
+    "var update = <REPLACE_WITH_UPDATE>;\n",
+    "\n",
+    "UpdateResult updateResult = <REPLACE_WITH_UPDATE_OPERATION>;\n",
+    "\n",
+    "System.out.println(\"Modified document count: \" + updateResult.getModifiedCount());"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6865fa4c",
+   "metadata": {},
+   "source": [
+    "## Summary\n",
+    "\n",
+    "In this section, we learned how to modify existing documents in MongoDB using operations such as `updateOne()` and update operators like `set()` and `addToSet()`.\n",
+    "\n",
+    "We also explored `upsert` behavior, where MongoDB inserts a new document if no existing document matches the update filter."
    ]
   }
  ],