docs: suggest adding performance comparison table for fs.promises vs callback API
Đang mở
Chưa có ai nhận issue này.
- Ngôn ngữ chính
- JavaScript
- Star
- 122k
- Fork
- 37.4k
- Merge trung bình
- 4 ngày 3 giờ
- Pull request đã merge (30 ngày)
- 272
Mô tả
建议
在 fs 模块文档中添加一个性能对比说明,解释 fs.promises API 与传统 callback API 在性能上的差异和适用场景。
背景
很多开发者在选择文件系统 API 时不清楚 promises 和 callback 版本的性能差异。添加以下内容会很有帮助:
- 高并发场景下的性能表现差异
- 内存使用对比
- 何时应该使用 callback 版本以获得最佳性能
这对于构建高吞吐量的 Node.js 应用很有参考价值。
Hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- 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.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Hướng nghiên cứu
Bắt đầu với tài liệu của module fs và các mô tả hiện có về promises và callback APIs. Hãy nghiên cứu hoặc xác minh các hướng dẫn được yêu cầu về hiệu năng khi có mức độ đồng thời cao, mức sử dụng bộ nhớ và việc lựa chọn callback trước khi thêm phần so sánh. Hoàn thành có nghĩa là tài liệu trình bày rõ ràng cả ba điểm mà không phóng đại những khác biệt không được hỗ trợ.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Đánh giá
- Công nghệ
- node.js
- Lĩnh vực
- documentation
- Loại issue
- Tài liệu
- Độ khó
- 3/5
- Thời gian dự kiến
- 1-2 ngày
- Mức độ hoạt động
- Sôi nổi
- Độ rõ ràng
- Khá rõ ràng
- Mức phù hợp với người mới
- 68/100