Skip to content

docs: add RxJS patterns to signals migration documentation#68764

Open
aanchalsh wants to merge 1 commit into
angular:mainfrom
aanchalsh:docs/rxjs-signals-migration-guide
Open

docs: add RxJS patterns to signals migration documentation#68764
aanchalsh wants to merge 1 commit into
angular:mainfrom
aanchalsh:docs/rxjs-signals-migration-guide

Conversation

@aanchalsh
Copy link
Copy Markdown

PR Checklist

Please check if your PR fulfills the following requirements:

  • The commit message follows Angular commit message guidelines
  • Tests for the changes have been added (not applicable for documentation changes)
  • Docs have been added / updated

PR Type

What kind of change does this PR introduce?

  • Bugfix
  • Feature
  • Code style update (formatting, local variables)
  • Refactoring (no functional changes, no api changes)
  • Build related changes
  • CI related changes
  • Documentation content changes
  • angular.dev application / infrastructure changes
  • Other

What is the current behavior?

The current RxJS interop documentation explains the core APIs (toSignal, toObservable, and rxResource) but does not provide practical migration guidance for developers transitioning from common RxJS patterns to Angular signals.

Issue Number: N/A

What is the new behavior?

This PR adds a migration guide for common RxJS patterns and their signal-based equivalents.

The documentation includes practical examples for:

  • BehaviorSubjectsignal
  • combineLatestcomputed
  • switchMapresource
  • distinctUntilChanged → signal equality
  • debounceTimetoObservable
  • takeUntilDestroyed → automatic cleanup

Additional improvements include:

  • Angular-style {avoid} and {prefer} migration examples
  • improved example consistency and readability
  • references to related RxJS interop documentation
  • updated examples using Angular-recommended patterns

Does this PR introduce a breaking change?

  • Yes
  • No

Other information

This PR focuses on improving the migration experience for developers adopting Angular signals in existing RxJS-heavy applications.

@pullapprove pullapprove Bot requested a review from MarkTechson May 17, 2026 11:11
@google-cla
Copy link
Copy Markdown

google-cla Bot commented May 17, 2026

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

@angular-robot angular-robot Bot added the area: docs Related to the documentation label May 17, 2026
@ngbot ngbot Bot added this to the Backlog milestone May 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: docs Related to the documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants