[Content]: Core concepts are referenced but not explained fully/clearly (tracked/reactive scopes and ownership)
#544 opened on Feb 26, 2024
Repository metrics
- Stars
- (289 stars)
- PR merge metrics
- (PR metrics pending)
Description
📚 Subject area/topic
Tracking scopes and ownership
📋 Page(s) affected (or suggested, for new content)
https://docs.solidjs.com/concepts/intro-to-reactivity#tracking-changes
And anywhere that mentions something like "signals must be accessed within a tracked/reactive scope"
https://docs.solidjs.com/reference/reactive-utilities/create-root
https://docs.solidjs.com/reference/reactive-utilities/get-owner
https://docs.solidjs.com/reference/reactive-utilities/run-with-owner
📋 Description of content that is out-of-date or incorrect
There are important concepts in solid like the idea of tracked/reactive scope or ownership that are mentioned but there isn't a place that clearly explains them.
Tracked/Reactive Scope
Signal updates will only be reacted to if they are accessed in a reactive or tracked scope, however I don't think there is a place that clearly outlines what all of the reactive scopes are.
Many examples just say to use createEffect or imply that JSX is a reactive scope but there isn't a place that goes through all of them or explains why the JSX template is a reactive scope.
- all of the different effects/computations
- createRoot (I don't fully understand how this works but in the OG docs it says the render function uses this to create the tracked scope for the app)
Owners
- What is an owner?
- What does it do?
- How does ownership work in solid?
- Why are they important?
🖥️ Reproduction in StackBlitz (if reporting incorrect content or code samples)
No response