Spec: `Final` section could use better definition for `Final` vs. `Final[X]`
Chưa có ai nhận issue này.
- 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ả
Came up in #2353: Currently, the syntax section for Final uses the following definitions:
Finalmay be used in one of several forms:
- With an explicit type, using the syntax
Final[<type>][...]- With no type annotation. [...]
As @carljm points out, these definitions are not great. I suggest to give them better names and use those consistently in the spec (and elsewhere). Carl used "bare" for the latter case, which I like. Maybe "explicitly typed" for the former? "When using a bare Final ..." or "When using an explicitly typed Final ..."
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
Bắt đầu với phần cú pháp của đặc tả dành cho Final và tìm trong đặc tả cũng như tài liệu liên quan các mô tả hiện có về Final và Final[X]. Được xem là hoàn tất khi hai dạng này có các định nghĩa rõ ràng, được đặt tên nhất quán, sử dụng các thuật ngữ như “bare” và “được kiểu hóa một cách tường minh”, mà không còn cách diễn đạt mâu thuẫn ở nơi khác.
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
- 72/100