Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Advertise into_pages() for pageable functions

Đang mở Phù hợp với người mới
#959 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
72/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
rust
Lĩnh vực
documentation

Hướng nghiên cứu

Kiểm tra mã tạo ra tài liệu cho các hàm pageable của Rust và so sánh với các bản tóm tắt và mô tả hiện có. Bổ sung hướng dẫn rằng Pager được trả về sẽ lặp qua các mục theo mặc định và into_pages() sẽ lặp qua các trang, thay T và P bằng các kiểu được sinh ra; xác minh tài liệu được tạo ra cho các hàm pageable.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

CodeGen rust

To better advertise that callers can iterate over pages and not just paged items, add documentation to the emitted functions like:

/// <existing summary>
///
/// <existing description, if any>
///
/// The returned `Pager<T>` will iterate over items of type `T` by default.
/// To iterate over each page of type `P`, call `into_pages()` on the returned `Pager<T>` before iterating any items.

Of course, replace T and P with the item type and page types, respectively.

Ngôn ngữ chính
Rust
Star
8
Fork
11
Merge trung bình
16 giờ 4 phút
Pull request đã merge (30 ngày)
5

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. 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.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của Azure/typespec-rust

Tất cả issue của Azure/typespec-rust

Issue tương tự

Thêm issue về Rust

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.