docs(core): improve Signals conceptual guidance#69204
Open
LuEsc wants to merge 4 commits into
Open
Conversation
This comment was marked as outdated.
This comment was marked as outdated.
bencodezen
reviewed
Jun 8, 2026
bencodezen
reviewed
Jun 8, 2026
bencodezen
reviewed
Jun 8, 2026
bencodezen
requested changes
Jun 8, 2026
Contributor
bencodezen
left a comment
There was a problem hiding this comment.
Thanks for the PR @LuEsc! There is a larger effort to rewrite the signal guides since there is a lot going on especially in the overview section. That said, this is good guidance to have for now. I've added some suggestions to improve what you wrote. Please let me know if you have any questions!
Co-authored-by: Ben Hong <ben@bencodezen.io>
Co-authored-by: Ben Hong <ben@bencodezen.io>
Co-authored-by: Ben Hong <ben@bencodezen.io>
5364583 to
4ee07e6
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
PR Checklist
Please check if your PR fulfills the following requirements:
PR Type
What kind of change does this PR introduce?
What is the current behavior?
The Signals overview guide explains the core APIs and reactive concepts, but it provides limited guidance on how to reason about Signals when designing applications.
In particular, the guide does not clearly explain:
Issue Number: N/A
What is the new behavior?
This PR adds conceptual guidance to the Signals overview guide, including:
A new "Mental model" section.
Guidance on preferring derivation over synchronization.
Recommendations for choosing between computed and effect.
A conceptual comparison between Signals and RxJS focused on use cases rather than APIs.
The goal is to help developers adopt the Signals programming model more effectively and avoid common architectural misunderstandings.
Does this PR introduce a breaking change?
Other information
This is a documentation-only change.