docs(forms): warn the user about getting old values and show how to avoid (#50123)

sr5434 · alxhub · commit 7baaed262d17 · 2023-05-08T14:34:54.000-07:00
PR Close #50123
diff --git a/packages/forms/src/model/abstract_model.ts b/packages/forms/src/model/abstract_model.ts
@@ -586,11 +586,12 @@ export abstract class AbstractControl<TValue = any, TRawValue extends TValue = T
    * A multicasting observable that emits an event every time the value of the control changes, in
    * the UI or programmatically. It also emits an event each time you call enable() or disable()
    * without passing along {emitEvent: false} as a function argument.
-   * 
-   * **Note**: the emit happens right after a value of this control is updated. The value of a parent control
-   * (for example if this FormControl is a part of a FormGroup) is updated after that, so accessing a value of
-   * a parent control (using the `value` property) from the callback of this event might result in getting a
-   * value that has not been updated yet. Subscribe to the `valueChanges` event of the parent control instead.
+   *
+   * **Note**: the emit happens right after a value of this control is updated. The value of a
+   * parent control (for example if this FormControl is a part of a FormGroup) is updated later, so
+   * accessing a value of a parent control (using the `value` property) from the callback of this
+   * event might result in getting a value that has not been updated yet. Subscribe to the
+   * `valueChanges` event of the parent control instead.
    */
   public readonly valueChanges!: Observable<TValue>;
 
