Consider moving the pipeline barrier explanation closer to where the parameters are set
Maintainer thường phản hồi trong vòng 1 ngày
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
- Sôi nổi
- Công nghệ
- cpp
- Lĩnh vực
- documentation
Hướng nghiên cứu
Đọc các phần Layout transitions và Transition barrier masks trên trang hướng dẫn được liên kết, sau đó so sánh vị trí giải thích các tham số của pipelineBarrier() với vị trí thiết lập các mask tương ứng. Di chuyển hoặc rút gọn phần giải thích như đề xuất để người đọc gặp các chi tiết cùng với nơi chúng được sử dụng; hoàn tất khi phần trước đó đề cập ngắn gọn rằng các mask sẽ được giải thích sau và phần giải thích chi tiết xuất hiện trong Transition barrier masks.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
In the Layout transitions section, the tutorial says:
The right values depend on the old and new layout, so we’ll get back to this once we’ve figured out which transitions we’re going to use.
However, the tutorial then spends several paragraphs explaining the parameters of pipelineBarrier(), including pipeline stages, access types, eByRegion, and different types of memory barriers. The actual stage and access masks are not set until the later Transition barrier masks section.
I found this order a bit confusing for a few reasons:
- The tutorial tells readers that these parameters will be handled later, but immediately goes into a fairly detailed explanation of them.
- The two layout transitions (
UNDEFINED→TRANSFER_DST_OPTIMALandTRANSFER_DST_OPTIMAL→SHADER_READ_ONLY_OPTIMAL) have already been introduced at this point, so the reason given for postponing the parameters is also a little unclear. - By the time the parameters are actually set, the reader has already moved through several other topics.
I think it would be easier to follow if the earlier section briefly mentioned that the stage and access masks would be filled in later, and left the detailed explanation for the Transition barrier masks section, where readers can immediately see how those parameters are used.
I don't think leaving the implementation incomplete is a problem by itself. It's mainly the placement of the explanation that makes the section harder to follow.
- Ngôn ngữ chính
- C++
- Star
- 444
- Fork
- 145
- Chỉ số merge pull request
- Không có pull request nào được merge trong 30 ngày
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Không có mẫu pull request
- Đọc 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.
Issue khác của KhronosGroup/Vulkan-Tutorial
-
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 85/100
KhronosGroup/Vulkan-Tutorial#545 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 76/100
KhronosGroup/Vulkan-Tutorial#544 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Clarify front-face culling when using a negative viewport heightCó thể đã có người làm @1sgtpepper đã nhận 18 ngày trước. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
KhronosGroup/Vulkan-Tutorial#534 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Stale GLSL-specific wording in the Vertex Input Description chapterCó thể đã có người làm @gpx1000 đã nhận 27 ngày trước. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 65/100
KhronosGroup/Vulkan-Tutorial#528 · 1 người được giao ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Clarify vertex input bindingsCó thể đã có người làm @SaschaWillems đã nhận 27 ngày trước. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
KhronosGroup/Vulkan-Tutorial#527 · 1 người được giao ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của KhronosGroup/Vulkan-Tutorial
Issue tương tự
-
Documentation: Fix parameter markup, legacy branch link, and phrasing in Detachable Joints and Model Command tutorialsCó thể đã có người làm @patelshivani2283-lab đã nhận hôm nay. Đang mở
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 88/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
Maintainer thường phản hồi trong vòng 1 ngày
-
bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
Niko1221/Strata#6071 · 2 bình luận ·
Maintainer thường phản hồi trong vòng 4 ngày
-
pumpĐang mở
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 68/100
dewenni/ESP_Buderus_KM271#191 ·