Bootstrapping the initiative: TODOs?
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức phù hợp với người mới
- 25/100
- Loại issue
- Tài liệu
- Độ rõ ràng
- Cần làm rõ
- Mức độ hoạt động
- Đình trệ
- Công nghệ
- javascript, node.js, typescript
- Lĩnh vực
- documentation
Hướng nghiên cứu
Start by reviewing the previous package.md documentation, the high-impact npm package research, and the linked Node.js discussion. Define the separate package-shipping scenarios and the community research needed before documenting recommendations. Done means the initiative has clear contribution and validation steps plus agreed documentation topics.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
A few TODOs come to mind:
- Starting a team for looking into the package shipping patterns. We'll need to set up contribution guidelines and team onboarding/offloading/consensus seeking. It would be great if we can get maintainers of bundlers and package automation tools involved to discuss and keep folks on the same page about the understanding of these practices.
- Looking into existing shipping patterns on npm. When I was investigating the module loading patterns of high-impact npm packages, I saw there are many packages out there using patterns that are not documented in the previous package.md. In fact the practices recommended by the previous documentation were considered less preferable in some cases. See https://github.com/nodejs/node/issues/52174 which recommends
node/defaultoverimport/require. We should look into documenting what the community actually does, and if necessary, document discussions about their pros and cons. - Discuss the recommended way to ship packages for various kinds of support goals. In particular, for these scenario
- A package that has been authored in TypeScript/ESM, and has been shipping dual or faux ESM, and wish to ship native ESM for newer versions of Node.js
- A package that has been authored in CJS, and wish to transition to ESM while maintaining CJS support for older Node.js releases while
require(esm)is still experimental. - ..more scenarios to come, we should open separate issues to track these, but we'll get more productive after 1 is done.
- Reaching out to existing high-impact packages that intend to ship native ESM to validate what we document
- Work with community content creators to spread the word about the recommended patterns and migration practices. Maybe also reach out to some high-impact tutorials/documentations out there to update too, to prevent future users from picking up the obsolete practices from the top search results.
- Ngôn ngữ chính
- JavaScript
- Star
- 87
- Fork
- 11
- Chỉ số merge pull request
- Không có pull request nào được merge trong 30 ngày
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.
Issue khác của nodejs/package-examples
-
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 25/100
nodejs/package-examples#17 · 11 bình luận · 1 reaction ·
-
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 20/100
nodejs/package-examples#3 · 8 bình luận · 6 reaction ·
Tất cả issue của nodejs/package-examples
Issue tương tự
-
bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
avniproject/avni-client#2135 ·
-
automated broken-link
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 85/100
-
agent/security hive/hosted-available-lke648397-260827-5n31 security
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 84/100
-
enhancement
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
babalae/bettergi-scripts-list#3674 ·
-
A-Release-Notes C-Editing D-Modest S-Ready-For-Implementation
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
bevyengine/bevy-website#2595 ·