Improve importlib backports-upstream integration
Chưa có ai nhận issue này.
- Ngôn ngữ chính
- Python
- Star
- 77.2k
- Fork
- 35.9k
- Chỉ số merge pull request
- Chỉ số pull request đang chờ
Mô tả
The current status-quo when it comes to the development integration/synchronization between the importlib backports and the CPython upstream isn't optimal.
Before anything else, I must properly acknowledge @jaraco's monumental and tireless effort on maintaining the importlib backports, and handling the complex synchronization with the CPython upstream, not to mention the continued development of these modules. It has been instrumental to get things to the state they are today, and none of the issues discussed in this thread should reflect negatively on him, but rather our failure to ensure these projects got the resources they need — a far too common tale in open-source.
Here are some issues I think we should improve:
- Synchronization process — even though @jaraco has left comments in some PRs describing his workflow, there's no properly documented process
- Authorship stripping — the current way changes are synced in and from the backports strip commit authorship
- Documentation fragmentation, resulting in a sub-optimal documentation
- Eg.
importlib.metadata.Distribution, and other classes, do not document their attributes (I regularly have to resort to the source code)
- Eg.
- CLA enforcement — the backports do not enforce the CLA
- Segmented development workflow — issues and changes happen in both places
- Source history — the current way changes are synced in and from the backports strip commit history
cc @python/importlib-team
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
Issue không nêu tên tệp hoặc bài kiểm thử nào. Hãy bắt đầu bằng việc xem xét importlib backports và quy trình đồng bộ hóa upstream của CPython, bao gồm thông tin tác giả, lịch sử mã nguồn, việc thực thi CLA và các vấn đề về tài liệu. Để được xem là hoàn tất, cần có một cải tiến đã được thống nhất đối với quy trình tích hợp, nhưng issue không xác định một triển khai cụ thể hay tiêu chí chấp nhậ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ệ
- python
- Lĩnh vực
- developer-experience, documentation, tooling
- Loại issue
- Tính năng
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức độ hoạt động
- Đình trệ
- Độ rõ ràng
- Cần làm rõ
- Mức phù hợp với người mới
- 25/100