docs: update doc to clear up difference between toObservable/ outputToObservable (#63836)

JeanMeche · thePunderWoman · commit 5ce4d9522df2 · 2025-09-16T15:00:54.000Z
TLDR: only `toObservable` emits synchronously on subscription. fixes #57224 PR Close #63836
diff --git a/packages/core/rxjs-interop/src/output_to_observable.ts b/packages/core/rxjs-interop/src/output_to_observable.ts
@@ -12,6 +12,7 @@ import {Observable} from 'rxjs';
 /**
  * Converts an Angular output declared via `output()` or `outputFromObservable()`
  * to an observable.
+ * It creates an observable that represents the stream of "events firing" in an output.
  *
  * You can subscribe to the output via `Observable.subscribe` then.
  *
diff --git a/packages/core/rxjs-interop/src/to_observable.ts b/packages/core/rxjs-interop/src/to_observable.ts
@@ -34,6 +34,7 @@ export interface ToObservableOptions {
 
 /**
  * Exposes the value of an Angular `Signal` as an RxJS `Observable`.
+ * As it reflects a state, the observable will always emit the latest value upon subscription.
  *
  * The signal's value will be propagated into the `Observable`'s subscribers using an `effect`.
  *

Original file line number	Diff line number	Diff line change
`@@ -12,6 +12,7 @@ import {Observable} from 'rxjs';`
`12`	`12`	`/**`
`13`	`13`	* Converts an Angular output declared via `output()` or `outputFromObservable()`
`14`	`14`	`* to an observable.`
	`15`	`+ * It creates an observable that represents the stream of "events firing" in an output.`
`15`	`16`	`*`
`16`	`17`	* You can subscribe to the output via `Observable.subscribe` then.
`17`	`18`	`*`
Original file line number	Diff line number	Diff line change
`@@ -34,6 +34,7 @@ export interface ToObservableOptions {`
`34`	`34`
`35`	`35`	`/**`
`36`	`36`	* Exposes the value of an Angular `Signal` as an RxJS `Observable`.
	`37`	`+ * As it reflects a state, the observable will always emit the latest value upon subscription.`
`37`	`38`	`*`
`38`	`39`	* The signal's value will be propagated into the `Observable`'s subscribers using an `effect`.
`39`	`40`	`*`