update

Author: LadyBluenotes

src/routes/reference/jsx-attributes/once.mdx

@@ -9,10 +9,10 @@ tags:
   - optimization
 version: "1.0"
 description: >-
-  Mark a JSX expression so the compiler does not wrap it reactively.
+  Mark a JSX expression as static at compile time.
 ---
 
-`/*@once*/` marks a JSX expression so the compiler does not wrap it reactively.
+`/*@once*/` is a compiler marker comment that marks a JSX expression as static.
 
 ## Syntax
 
@@ -23,8 +23,9 @@ description: >-
 ## Behavior
 
 - `/*@once*/` applies to the expression that follows it.
-- It tells the compiler not to wrap that expression in reactive access machinery.
+- Marked expressions are compiled as static and do not update when reactive dependencies change.
 - It can be used in props and in children.
+- Some compiler transforms, including parts of `classList` and `style` handling, do not fully respect `/*@once*/`.
 
 ## Examples