Skip to content

Commit b462664

Browse files
authored
[compiler] Flesh out incremental adoption intro more (#7890)
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.
1 parent d7160a8 commit b462664

File tree

1 file changed

+6
-5
lines changed

1 file changed

+6
-5
lines changed

src/content/learn/react-compiler/incremental-adoption.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -19,12 +19,13 @@ React Compiler can be adopted incrementally, allowing you to try it on specific
1919

2020
## Why Incremental Adoption? {/*why-incremental-adoption*/}
2121

22-
While React Compiler is designed to handle most React code automatically, adopting it incrementally allows you to:
22+
React Compiler is designed to optimize your entire codebase automatically, but you don't have to adopt it all at once. Incremental adoption gives you control over the rollout process, letting you test the compiler on small parts of your app before expanding to the rest.
2323

24-
- Test the compiler on a small portion of your app first
25-
- Identify and fix any Rules of React violations
26-
- Build confidence before expanding to your entire codebase
27-
- Minimize risk in production applications
24+
Starting small helps you build confidence in the compiler's optimizations. You can verify that your app behaves correctly with compiled code, measure performance improvements, and identify any edge cases specific to your codebase. This approach is especially valuable for production applications where stability is critical.
25+
26+
Incremental adoption also makes it easier to address any Rules of React violations the compiler might find. Instead of fixing violations across your entire codebase at once, you can tackle them systematically as you expand compiler coverage. This keeps the migration manageable and reduces the risk of introducing bugs.
27+
28+
By controlling which parts of your code get compiled, you can also run A/B tests to measure the real-world impact of the compiler's optimizations. This data helps you make informed decisions about full adoption and demonstrates the value to your team.
2829

2930
## Approaches to Incremental Adoption {/*approaches-to-incremental-adoption*/}
3031

0 commit comments

Comments
 (0)