reactjs / reactjs/react.dev

Suspense feature description ambiguity between release note and React API reference

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

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

Ngôn ngữ chính
JavaScript
Star
11.8k
Fork
7.9k
Merge trung bình
1 ngày 11 giờ
Pull request đã merge (30 ngày)
11

Mô tả

On actual (v18.2.0) React API reference page (https://reactjs.org/docs/react-api.html) is written:

Today, lazy loading components is the only use case supported by <React.Suspense>:

and

In the future we plan to let Suspense handle more scenarios such as data fetching. You can read about this in our roadmap.

(also interesting that this link referring into React 16 Roadmap while we have 18 released.)

At the same time React 18 Release Page says that:

In React 18, you can start using Suspense for data fetching in opinionated frameworks like Relay, Next.js, Hydrogen, or Remix.

and looks like 'Suspense for data fetching' can be used and information in React API reference in outdated?

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

So sánh tài liệu tham chiếu API của React tại reactjs.org/docs/react-api.html với phần về Suspense trong các framework dữ liệu trên trang phát hành React 18. Kiểm tra xem tài liệu tham chiếu API và liên kết đến lộ trình React 16 của nó có mô tả chính xác các trường hợp sử dụng được hỗ trợ hay không, sau đó cập nhật phần diễn đạt mâu thuẫn và xác minh rằng cả hai trang vẫn nhất quán.

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

Đánh giá

Công nghệ
javascript, react
Lĩnh vực
documentation
Loại issue
Tài liệu
Độ khó
2/5
Thời gian dự kiến
1-3 giờ
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
38/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.