diff --git a/site/content/docs/01-component-format.md b/site/content/docs/01-component-format.md
index e3e423526f..692d50bd1e 100644
--- a/site/content/docs/01-component-format.md
+++ b/site/content/docs/01-component-format.md
@@ -279,9 +279,11 @@ To apply styles to a selector globally, use the `:global(...)` modifier.
 	}
 
 	p:global(.red) {
-		/* this will apply to <p> elements belonging to this 
-			 component that have the class "red" dynamically
-			 applied (e.g. via node.classList.add) */
+		/* this will apply to all <p> elements belonging to this 
+			 component with a class of red, even if class="red" does
+			 not appear in the markup. This is useful when the class 
+			 of the element is dynamically applied, for instance 
+			 when updating the element's classList property directly. */
 	}
 </style>
 ```