Spec: PEP leftovers in the spec for literals
Đang mở
Phù hợp với người mới
Chưa có ai nhận issue này.
topic: typing spec
- Ngôn ngữ chính
- Python
- Star
- 1.8k
- Fork
- 302
- Merge trung bình
- 23 giờ
- Pull request đã merge (30 ngày)
- 8
Mô tả
There are some sections in the spec for literals that made sense as a rationale or look into the future in the PEP, but should be removed in the spec for conciseness, clarity, and consistency:
- An (incomplete) list of illegal parameters for
Literal. Since this immediately succeeds a positive, exclusive list of what parameters are allowed, this is just fluff and I believe the whole section should just be removed. - The next section is titled "Parameters at runtime" and details implementation details for
Literal. These seem unnecessary for the typing spec and are in danger of getting desynched with the actual implementation.
Hướng dẫn đóng góp
Chưa lập chỉ mục được hướng dẫn đóng góp cho kho mã nguồn này
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
Mở đặc tả về literal và xác định các phần về tham số không hợp lệ và tham số tại thời điểm chạy được đề cập trong issue. Xóa các phần về lý do và chi tiết triển khai trong khi vẫn giữ phần mô tả mang tính quy phạm ngắn gọn, sau đó xem lại đặc tả đã được render để xác nhận nội dung xung quanh vẫn rõ ràng.
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
- 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
- Sôi nổi
- Độ rõ ràng
- Khá rõ ràng
- Mức phù hợp với người mới
- 75/100