diff --git a/engine/sprite.odin b/engine/sprite.odin
index e3883c8..37eed98 100644
--- a/engine/sprite.odin
+++ b/engine/sprite.odin
@@ -8,7 +8,7 @@ Sprite :: struct {
 	data:      ^Character_Data,
 	position:  Vec2,
 	clip:      string,
-	clip_def:  Clip_Def, // shallow cache; frames alias Character_Data (do not mutate clips map after spawn)
+	clip_def:  Clip_Def,
 	has_clip:  bool,
 	frame:     int,
 	time:      f32,
diff --git a/examples/crowd/main.odin b/examples/crowd/main.odin
index 6efa950..55f64ad 100644
--- a/examples/crowd/main.odin
+++ b/examples/crowd/main.odin
@@ -3,7 +3,7 @@ package main
 import "core:fmt"
 import eng "pkg:engine"
 
-// Stress the draw budget: one Character_Data, MAX_SPRITES instances.
+// Many sprites sharing one Character_Data (Flyweight) — good batching demo.
 COUNT :: eng.MAX_SPRITES
 COLS :: 16
 FRAME_LOG_EVERY :: 60