diff --git a/pkg/schema/fbs/report.fbs b/pkg/schema/fbs/report.fbs
index 46aa5aa..24301d8 100644
--- a/pkg/schema/fbs/report.fbs
+++ b/pkg/schema/fbs/report.fbs
@@ -199,7 +199,8 @@ table LocalFleet {
 // BattleSummary identifies one battle the report recipient
 // participated in or could see on a planet. `planet` lets the map
 // place a battle marker without fetching the full BattleReport;
-// `shots` lets the marker scale its stroke with the protocol length.
+// `shots` lets the marker scale its stroke with the protocol length
+// (1 shot → thinnest cross, 100+ shots → maximum cross thickness).
 table BattleSummary {
   id:common.UUID (required);
   planet:uint64;