From f7d834b0c9934cb04341240aa3e4113689a74ab9 Mon Sep 17 00:00:00 2001
From: Vijay Janapa Reddi <vj@eecs.harvard.edu>
Date: Sun, 8 Mar 2026 14:23:12 -0400
Subject: [PATCH] updated CARD

---
 .../contents/vol1/ml_systems/ml_systems.qmd    | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/book/quarto/contents/vol1/ml_systems/ml_systems.qmd b/book/quarto/contents/vol1/ml_systems/ml_systems.qmd
index d0cd34733..c5481d7e1 100644
--- a/book/quarto/contents/vol1/ml_systems/ml_systems.qmd
+++ b/book/quarto/contents/vol1/ml_systems/ml_systems.qmd
@@ -781,10 +781,28 @@ The TinyML lighthouse, **Keyword Spotting (KWS)**\index{Keyword Spotting (KWS)!T
 ```{python}
 #| echo: false
 #| label: doorbell-scorecard
+# ┌─────────────────────────────────────────────────────────────────────────────
+# │ DOORBELL SCORECARD (FIGURE)
+# ├─────────────────────────────────────────────────────────────────────────────
+# │ Context: Lighthouse model evaluation
+# │ Goal: Visualize the radar plot scorecard for the smart doorbell application
+# └─────────────────────────────────────────────────────────────────────────────
+
+# ┌── 1. CANVAS ────────────────────────────────────────────────────────────────
+# │ Initialize the visualization modules
 import mlsysim
 import matplotlib.pyplot as plt
+
+# ┌── 2. ARRAYS ────────────────────────────────────────────────────────────────
+# │ Load the evaluation data for the Doorbell scenario
 doorbell_eval = mlsysim.Applications.Doorbell.evaluate()
+
+# ┌── 3. RENDER ────────────────────────────────────────────────────────────────
+# │ Plot the radar scorecard using the mlsysim helper
 fig, ax = mlsysim.plot_evaluation_scorecard(doorbell_eval)
+
+# ┌── 4. DECORATE ──────────────────────────────────────────────────────────────
+# │ Display the figure
 plt.show()
 ```