solidjs / solidjs/solid-docs

[Content]: Core concepts are referenced but not explained fully/clearly (tracked/reactive scopes and ownership)

Đang mở
#544 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

good first issue help wanted solid
Ngôn ngữ chính
MDX
Star
292
Fork
361
Merge trung bình
7 giờ 51 phút
Pull request đã merge (30 ngày)
1

Mô tả

📚 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

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Hướng nghiên cứu

Bắt đầu bằng cách đọc phần tracking-changes và các trang tham chiếu create-root, get-owner và run-with-owner. Xác định nơi tracked/reactive scopes và ownership hiện đang được đề cập, sau đó ghi lại chúng là gì, hoạt động như thế nào và tại sao chúng quan trọng, bao gồm các effects, computations và hành vi JSX được liệt kê.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Đánh giá

Lĩnh vực
documentation
Loại issue
Tài liệu
Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức độ hoạt động
Đình trệ
Độ rõ ràng
Khá rõ ràng
Mức phù hợp với người mới
35/100

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.