Update docs/api-reference/configuration.md

AbanoubGhadban · justin808 · commit 1076a8c55bb9 · 2025-11-12T12:42:46.000-10:00
diff --git a/docs/api-reference/configuration.md b/docs/api-reference/configuration.md
@@ -271,7 +271,7 @@ ReactOnRails.configure do |config|
   #
   # - :defer (default for non-Pro, recommended): Scripts load in parallel but execute in order
   #   after HTML parsing. Prevents race conditions where components render before registration.
-  # - :sync: Scripts block HTML parsing while loading (not recommended, slowest option).
+  # - :sync: Scripts block HTML parsing while loading (not recommended, slowest option and can still cause race conditions in the non-pro version if the component is hydrated before its SSR-generated HTML appears in the DOM).
   # - :async (Pro only): Scripts load and execute as soon as available. Requires Pro's
   #   immediate_hydration feature to prevent race conditions.
   #

Original file line number	Diff line number	Diff line change
`@@ -271,7 +271,7 @@ ReactOnRails.configure do \|config\|`
`271`	`271`	`#`
`272`	`272`	`# - :defer (default for non-Pro, recommended): Scripts load in parallel but execute in order`
`273`	`273`	`# after HTML parsing. Prevents race conditions where components render before registration.`
`274`		`- # - :sync: Scripts block HTML parsing while loading (not recommended, slowest option).`
	`274`	`+ # - :sync: Scripts block HTML parsing while loading (not recommended, slowest option and can still cause race conditions in the non-pro version if the component is hydrated before its SSR-generated HTML appears in the DOM).`
`275`	`275`	`# - :async (Pro only): Scripts load and execute as soon as available. Requires Pro's`
`276`	`276`	`# immediate_hydration feature to prevent race conditions.`
`277`	`277`	`#`