@@ -79,7 +79,8 @@ Free. Open-source. Community-driven. Generated by [Berta AI](https://berta.one).
|---|---------|-------|----------|
| 6 | [Introduction to Machine Learning](chapters/chapter-06.md) | 8h | 3 notebooks, 5 exercises, 3 diagrams |
| 7 | [Supervised Learning](chapters/chapter-07.md) | 10h | 3 notebooks, 5 exercises, 3 diagrams |
-| 8β25 | Coming soon | | [View roadmap](guides/roadmap.md) |
+| 8 | [Unsupervised Learning](chapters/chapter-08.md) | 8h | 3 notebooks, 5 exercises, 3 diagrams |
+| 9β25 | Coming soon | | [View roadmap](guides/roadmap.md) |
---
diff --git a/mkdocs.yml b/mkdocs.yml
index 97b5818..591ae44 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -133,6 +133,10 @@ nav:
- "7.1 Introduction": chapters/content/ch07-01_introduction.md
- "7.2 Intermediate": chapters/content/ch07-02_intermediate.md
- "7.3 Advanced": chapters/content/ch07-03_advanced.md
+ - "Ch 8: Unsupervised Learning": chapters/chapter-08.md
+ - "8.1 Introduction": chapters/content/ch08-01_introduction.md
+ - "8.2 Intermediate": chapters/content/ch08-02_intermediate.md
+ - "8.3 Advanced": chapters/content/ch08-03_advanced.md
- Playground: playground.md
- Community:
- Contributing: guides/contributing.md
diff --git a/netlify.toml b/netlify.toml
index 75b89e4..7319110 100644
--- a/netlify.toml
+++ b/netlify.toml
@@ -1,10 +1,23 @@
[build]
command = "pip install mkdocs-material mkdocs-minify-plugin && mkdocs build"
publish = "site"
+ functions = "netlify/functions"
[build.environment]
PYTHON_VERSION = "3.11"
+# Newsletter: auto-sends on deploy when chapter_notification.json changes.
+# One-time setup in Netlify Dashboard > Site settings > Environment variables:
+# RESEND_API_KEY = your Resend API key
+# CONFIRM_FROM_EMAIL = verified sender email
+# SITE_URL = https://chapters.berta.one
+# NETLIFY_API_TOKEN = personal access token (app.netlify.com/user/applications)
+# NETLIFY_SITE_ID = site ID (Site settings > General)
+#
+# To notify subscribers about a new chapter:
+# 1. Edit netlify/functions/chapter_notification.json
+# 2. Commit and deploy β done. No dashboard changes needed.
+
[[redirects]]
from = "/chapters"
to = "/chapters/"
diff --git a/netlify/functions/chapter_notification.json b/netlify/functions/chapter_notification.json
new file mode 100644
index 0000000..b422030
--- /dev/null
+++ b/netlify/functions/chapter_notification.json
@@ -0,0 +1,5 @@
+{
+ "chapter_number": 8,
+ "chapter_title": "Unsupervised Learning",
+ "chapter_description": "K-Means clustering, hierarchical clustering, DBSCAN, PCA, t-SNE, anomaly detection, and a customer segmentation capstone project."
+}
diff --git a/netlify/functions/deploy-succeeded.js b/netlify/functions/deploy-succeeded.js
new file mode 100644
index 0000000..afb4f91
--- /dev/null
+++ b/netlify/functions/deploy-succeeded.js
@@ -0,0 +1,225 @@
+/**
+ * Netlify Function: deploy-succeeded (Background Event)
+ *
+ * Automatically triggered after every successful Netlify deploy.
+ * Reads chapter_notification.json to determine what to notify about,
+ * then checks LAST_NOTIFIED_CHAPTER to avoid re-sending.
+ *
+ * How to send a newsletter for a new chapter:
+ * 1. Update chapter_notification.json with the new chapter details.
+ * 2. Commit, push, and deploy. That's it.
+ *
+ * The function compares the chapter number in the JSON file against
+ * LAST_NOTIFIED_CHAPTER (stored as a Netlify env var). If they differ,
+ * it fetches all subscribers from Netlify Forms and emails them via
+ * Resend, then updates LAST_NOTIFIED_CHAPTER so subsequent deploys
+ * won't re-send.
+ *
+ * One-time setup (Netlify Dashboard > Site settings > Environment variables):
+ * RESEND_API_KEY - Resend API key
+ * CONFIRM_FROM_EMAIL - Verified sender email in Resend
+ * SITE_URL - https://chapters.berta.one
+ * NETLIFY_API_TOKEN - Personal access token (app.netlify.com/user/applications)
+ * NETLIFY_SITE_ID - Site ID (Site settings > General)
+ *
+ * No per-release changes needed in the dashboard.
+ */
+
+var config = require("./chapter_notification.json");
+
+exports.handler = async function () {
+ var chapterNumber = String(config.chapter_number);
+ var chapterTitle = config.chapter_title;
+ var chapterDescription = config.chapter_description;
+
+ var lastNotified = process.env.LAST_NOTIFIED_CHAPTER || "";
+ if (lastNotified === chapterNumber) {
+ console.log("Chapter " + chapterNumber + " already notified β skipping");
+ return { statusCode: 200, body: "Already notified for chapter " + chapterNumber };
+ }
+
+ var apiKey = process.env.RESEND_API_KEY;
+ if (!apiKey) {
+ console.log("RESEND_API_KEY not set β cannot send emails");
+ return { statusCode: 200, body: "No email service configured" };
+ }
+
+ var netlifyToken = process.env.NETLIFY_API_TOKEN;
+ var siteId = process.env.NETLIFY_SITE_ID;
+ if (!netlifyToken || !siteId) {
+ console.log("NETLIFY_API_TOKEN or NETLIFY_SITE_ID not set");
+ return { statusCode: 200, body: "Netlify API not configured" };
+ }
+
+ var fromEmail = process.env.CONFIRM_FROM_EMAIL || "onboarding@resend.dev";
+ var siteUrl = process.env.SITE_URL || "https://chapters.berta.one";
+
+ // ββ Fetch subscribers from Netlify Forms ββ
+ var subscribers = [];
+ try {
+ var formsRes = await fetch(
+ "https://api.netlify.com/api/v1/sites/" + siteId + "/forms",
+ { headers: { "Authorization": "Bearer " + netlifyToken } }
+ );
+ if (!formsRes.ok) {
+ console.log("Failed to fetch forms: HTTP " + formsRes.status);
+ return { statusCode: 200, body: "Failed to fetch forms" };
+ }
+ var forms = await formsRes.json();
+ var newsletterForm = forms.find(function (f) { return f.name === "newsletter"; });
+
+ if (!newsletterForm) {
+ console.log("Newsletter form not found");
+ return { statusCode: 200, body: "Newsletter form not found" };
+ }
+
+ var page = 1;
+ var perPage = 100;
+ while (true) {
+ var subsRes = await fetch(
+ "https://api.netlify.com/api/v1/forms/" + newsletterForm.id +
+ "/submissions?per_page=" + perPage + "&page=" + page,
+ { headers: { "Authorization": "Bearer " + netlifyToken } }
+ );
+ if (!subsRes.ok) break;
+ var subs = await subsRes.json();
+ if (!subs || subs.length === 0) break;
+ for (var i = 0; i < subs.length; i++) {
+ var email = subs[i].data && subs[i].data.email;
+ if (email && subscribers.indexOf(email) === -1) {
+ subscribers.push(email);
+ }
+ }
+ if (subs.length < perPage) break;
+ page++;
+ }
+ } catch (err) {
+ console.log("Error fetching subscribers: " + err.message);
+ return { statusCode: 500, body: "Failed to fetch subscribers" };
+ }
+
+ if (subscribers.length === 0) {
+ console.log("No subscribers found");
+ return { statusCode: 200, body: "No subscribers" };
+ }
+
+ console.log("Sending Chapter " + chapterNumber + ": " + chapterTitle +
+ " notification to " + subscribers.length + " subscriber(s)");
+
+ // ββ Build email ββ
+ var chapterUrl = siteUrl + "/chapters/chapter-" +
+ (parseInt(chapterNumber) < 10 ? "0" : "") + chapterNumber + "/";
+
+ var htmlBody = [
+ "
",
+ "
New Chapter Published!
",
+ "
Chapter " + chapterNumber + ": " + chapterTitle + "
",
+ "
" + chapterDescription + "
",
+ "
",
+ " ",
+ " Read Chapter " + chapterNumber + " Now",
+ "
",
+ "
",
+ "
What's included:
",
+ "
",
+ " - 3 interactive notebooks (Introduction, Intermediate, Advanced)
",
+ " - 5 exercises with complete solutions
",
+ " - Production-ready toolkit scripts
",
+ " - 3 SVG diagrams
",
+ " - Synthetic datasets for hands-on practice
",
+ "
",
+ "
Browse all chapters | ",
+ " Try the Playground
",
+ "
",
+ "
",
+ " You're receiving this because you subscribed at " + siteUrl + "
",
+ " To unsubscribe, reply to this email with 'unsubscribe'.",
+ "
",
+ "
",
+ " Created by Luigi Pascal Rondanini | ",
+ " Powered by Berta AI",
+ "
",
+ "
",
+ ].join("\n");
+
+ // ββ Send emails ββ
+ var sent = 0;
+ var failed = 0;
+
+ for (var j = 0; j < subscribers.length; j++) {
+ try {
+ var response = await fetch("https://api.resend.com/emails", {
+ method: "POST",
+ headers: {
+ "Authorization": "Bearer " + apiKey,
+ "Content-Type": "application/json",
+ },
+ body: JSON.stringify({
+ from: "Berta Chapters <" + fromEmail + ">",
+ to: [subscribers[j]],
+ subject: "New Chapter: " + chapterTitle + " (Chapter " + chapterNumber + ")",
+ html: htmlBody,
+ }),
+ });
+
+ if (response.ok) {
+ sent++;
+ console.log("Sent to " + subscribers[j]);
+ } else {
+ failed++;
+ var errorText = await response.text();
+ console.log("Failed: " + subscribers[j] + " β " + errorText);
+ }
+ } catch (err) {
+ failed++;
+ console.log("Error: " + subscribers[j] + " β " + err.message);
+ }
+ }
+
+ // ββ Update LAST_NOTIFIED_CHAPTER via Netlify API ββ
+ if (sent > 0) {
+ try {
+ // Fetch existing env vars for this account (scoped to site)
+ var envRes = await fetch(
+ "https://api.netlify.com/api/v1/accounts/me/env?site_id=" + siteId,
+ { headers: { "Authorization": "Bearer " + netlifyToken } }
+ );
+ var envVars = await envRes.json();
+ var existing = Array.isArray(envVars)
+ ? envVars.find(function (v) { return v.key === "LAST_NOTIFIED_CHAPTER"; })
+ : null;
+
+ if (existing) {
+ // Delete then recreate (Netlify API pattern for updating)
+ await fetch(
+ "https://api.netlify.com/api/v1/accounts/me/env/LAST_NOTIFIED_CHAPTER?site_id=" + siteId,
+ { method: "DELETE", headers: { "Authorization": "Bearer " + netlifyToken } }
+ );
+ }
+ await fetch(
+ "https://api.netlify.com/api/v1/accounts/me/env?site_id=" + siteId,
+ {
+ method: "POST",
+ headers: {
+ "Authorization": "Bearer " + netlifyToken,
+ "Content-Type": "application/json",
+ },
+ body: JSON.stringify([{
+ key: "LAST_NOTIFIED_CHAPTER",
+ scopes: ["functions"],
+ values: [{ value: chapterNumber, context: "all" }],
+ }]),
+ }
+ );
+ console.log("Updated LAST_NOTIFIED_CHAPTER to " + chapterNumber);
+ } catch (err) {
+ console.log("Could not update LAST_NOTIFIED_CHAPTER: " + err.message);
+ }
+ }
+
+ var summary = "Chapter " + chapterNumber + " β Sent: " + sent +
+ ", Failed: " + failed + ", Total: " + subscribers.length;
+ console.log(summary);
+ return { statusCode: 200, body: summary };
+};
diff --git a/netlify/functions/submission-created.js b/netlify/functions/submission-created.js
index 9a272f4..8aefae5 100644
--- a/netlify/functions/submission-created.js
+++ b/netlify/functions/submission-created.js
@@ -41,9 +41,12 @@ exports.handler = async function (event) {
"
Thank you for subscribing to updates.
",
"
You'll receive an email when new chapters are published. At most one email per week.
",
"
",
+ "
Latest chapter:
",
+ "
Chapter 8: Unsupervised Learning β ",
+ " K-Means, hierarchical clustering, DBSCAN, PCA, t-SNE, anomaly detection, and a customer segmentation capstone.
",
"
Start learning now:
",
"
",
diff --git a/wiki/Home.md b/wiki/Home.md
index 83c9da6..3a61a8c 100644
--- a/wiki/Home.md
+++ b/wiki/Home.md
@@ -47,7 +47,7 @@ A full journey from basics to advanced AI:
- **Practitioner (Ch 6β15)** β ML intro, supervised learning, deep learning, NLP, RAG, MLOps
- **Advanced (Ch 16β25+)** β Multi-agent systems, reinforcement learning, production AI, ethics
-**7 chapters available now** (56 hours of content). More unlock as the community grows.
+**8 chapters available now** (64 hours of content). More unlock as the community grows.
### 2. Community-Requested Chapters β Learn What You Need
@@ -121,7 +121,7 @@ Same format everywhere. Learn once, then move fast.
| **Advanced** | 16β25+ | π Planned |
| **Community** | Your requests | π Unlimited |
-**21 notebooks**, **37 exercises with solutions**, **5 datasets**, **21 diagrams**. All open and ready to run.
+**24 notebooks**, **42 exercises with solutions**, **7 datasets**, **24 diagrams**. All open and ready to run.
---