docs(core): clarify provideZoneChangeDetection usage in v21+

angular-bootstrap · atscott · commit 09638ec7c3f1 · 2026-03-10T17:21:13.000Z
Clarify that provideZoneChangeDetection() is used to opt applications into NgZone/ZoneJS-based change detection and to configure NgZone options such as eventCoalescing. Fixes #67498 (cherry picked from commit 1969338)
diff --git a/packages/core/src/change_detection/scheduling/ng_zone_scheduling.ts b/packages/core/src/change_detection/scheduling/ng_zone_scheduling.ts
@@ -134,8 +134,8 @@ export function internalProvideZoneChangeDetection({
  * Provides `NgZone`-based change detection for the application bootstrapped using
  * `bootstrapApplication`.
  *
- * `NgZone` is already provided in applications by default. This provider allows you to configure
- * options like `eventCoalescing` in the `NgZone`.
+ * Add this provider to use `NgZone`/ZoneJS-based change detection and configure options like
+ * `eventCoalescing` in the `NgZone`.
  *
  * If you need this provider function in an NgModule-based application, pass it as `applicationProviders` to `bootstrapModule()`.
  *

Original file line number	Diff line number	Diff line change
`@@ -134,8 +134,8 @@ export function internalProvideZoneChangeDetection({`
`134`	`134`	* Provides `NgZone`-based change detection for the application bootstrapped using
`135`	`135`	* `bootstrapApplication`.
`136`	`136`	`*`
`137`		- * `NgZone` is already provided in applications by default. This provider allows you to configure
`138`		- * options like `eventCoalescing` in the `NgZone`.
	`137`	+ * Add this provider to use `NgZone`/ZoneJS-based change detection and configure options like
	`138`	+ * `eventCoalescing` in the `NgZone`.
`139`	`139`	`*`
`140`	`140`	* If you need this provider function in an NgModule-based application, pass it as `applicationProviders` to `bootstrapModule()`.
`141`	`141`	`*`