Skip to content

docs(signals): clarify when to use linkedSignal vs computed#67324

Open
anushkasingh-commits wants to merge 5 commits intoangular:mainfrom
anushkasingh-commits:main
Open

docs(signals): clarify when to use linkedSignal vs computed#67324
anushkasingh-commits wants to merge 5 commits intoangular:mainfrom
anushkasingh-commits:main

Conversation

@anushkasingh-commits
Copy link
Contributor

What does this PR do?

Adds a short clarifying paragraph explaining when linkedSignal should be preferred over computed.

The existing documentation explains how linkedSignal works, but readers may still be unsure about the conceptual difference between derivation (computed) and writable derived state (linkedSignal).
This PR introduces a small inline paragraph to clarify that linkedSignal is useful when derived state must remain writable or preserve user-driven updates while still reacting to a source signal.

Why is this change needed?

While reading the guide, it was not immediately clear when to choose linkedSignal instead of computed.
This clarification aims to reduce that confusion for future readers without restructuring the existing documentation.

Scope

  • Documentation only
  • No behavioral changes
  • Keeps the existing structure and tone of the guide

@pullapprove pullapprove bot requested a review from AndrewKushnir February 26, 2026 14:28
@angular-robot angular-robot bot added the area: docs Related to the documentation label Feb 26, 2026
@thePunderWoman thePunderWoman added area: docs Related to the documentation and removed area: docs Related to the documentation labels Feb 26, 2026
@ngbot ngbot bot added this to the Backlog milestone Feb 26, 2026
@MeAkib
Copy link
Contributor

MeAkib commented Feb 26, 2026

Could you please rebase so it can be a single commit?

@AndrewKushnir AndrewKushnir requested review from pkozlowski-opensource and removed request for AndrewKushnir February 26, 2026 17:18
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.

3 participants