[compiler] Add note about gating evaluation (#7891)

* [compiler] Flesh out incremental adoption intro more Previously the intro was pretty barebones. Fleshed it out a bit more to describe why it might be useful to reach for in a large codebase. * [compiler] Add note about gating evaluation Clarify when the gating function is evaluated.
reactjs · react-translations-bot · Jul 21, 2025 · Jul 21, 2025 · Jul 21, 2025 · Jul 21, 2025
commit b6450e8f2d89235350932e332195f8549dcf2391
diff --git a/src/content/reference/react-compiler/gating.md b/src/content/reference/react-compiler/gating.md
@@ -63,7 +63,7 @@ Configures runtime feature flag gating for compiled functions.
 // src/utils/feature-flags.js
 export function shouldUseCompiler() {
   // your logic here
-  return Math.random() < 0.5;
+  return getFeatureFlag('react-compiler-enabled');
 }
 ```
 
@@ -94,6 +94,8 @@ const Button = shouldUseCompiler()
   : function Button_original(props) { /* original version */ };
 ```
 
+Note that the gating function is evaluated once at module time, so once the JS bundle has been parsed and evaluated the choice of component stays static for the rest of the browser session.
+
 ---
 
 ## Troubleshooting {/*troubleshooting*/}