microsoft / microsoft/TypeScript-Website
Somewhat unfortunate example on void return type on a fetching function
Chưa có ai nhận issue này.
- Ngôn ngữ chính
- TypeScript
- Star
- 2.6k
- Fork
- 1.5k
- Merge trung bình
- 2 ngày 2 giờ
- Pull request đã merge (30 ngày)
- 7
Mô tả
https://github.com/microsoft/TypeScript-Website/blame/0612591abc2d8292c8ddd084b5fb264f203b7026/packages/documentation/copy/en/declaration-files/Do's and Don'ts.md#L81
Sorry if this is overthinking - i am new to typescript.
You are giving a DO example with an interface called "Fetcher" that defines getObject but returning nothing aka void. I think I got the point of "Do write callback parameters as non-optional", but the context is somewhat unfortunate. Maybe there can be thought of a better example for non-optional callback parameters?
Another way to phrase my thought: Is it a DO to use return type void on a getter-Method?
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 tại packages/documentation/copy/en/declaration-files/Do's and Don'ts.md, ở ví dụ được liên kết quanh dòng 81. Đọc phần hướng dẫn xung quanh về các tham số callback không tùy chọn và đánh giá xem ví dụ Fetcher có phân biệt rõ điểm đó với vấn đề về kiểu trả về void hay không. Được xem là hoàn tất khi ví dụ hoặc cách diễn đạt truyền đạt tốt hơn hướng dẫn dự kiế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ệ
- typescript
- 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
- Đình trệ
- Độ rõ ràng
- Khá rõ ràng
- Mức phù hợp với người mới
- 38/100