Consider moving the pipeline barrier explanation closer to where the parameters are set
維護者通常 1 天內回覆
還沒有人認領這個 Issue。
評估
- 難度
- 2/5
- 預估耗時
- 1-3 小時
- 新手友好度
- 72/100
- Issue 類型
- 文件
- 描述清晰度
- 描述清楚
- 活躍度
- 活躍
- 技術堆疊
- cpp
研究方向
閱讀連結教學頁面中的 Layout transitions 和 Transition barrier masks 章節,然後比較 pipelineBarrier() 參數的說明位置與其 mask 的設定位置。依照提議移動或精簡說明,讓讀者在看到這些參數的用法時也能看到相關細節;完成的標準是前面的章節簡要說明 mask 會在後文介紹,而詳細說明出現在 Transition barrier masks 中。
由索引模型根據 Issue 內容生成。
描述
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.
- 主要語言
- C++
- 星號
- 444
- 分支
- 145
- PR 合併指標
- 30 天內沒有已合併 PR
環境準備
- 沒有 Dockerfile 或 Docker Compose 檔案
- 沒有 Pull Request 範本
- 閱讀貢獻指南
從這裡開始
- 先讀完整個 Issue,再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫,在一個分支上完成修改。
- 送出 Pull Request,並在描述裡引用這個 Issue 編號。
KhronosGroup/Vulkan-Tutorial 的其他 Issue
-
難度 1/5 1 小時以內 新手友好度 85/100
KhronosGroup/Vulkan-Tutorial#545 ·
維護者通常 1 天內回覆
-
難度 1/5 1-3 小時 新手友好度 76/100
KhronosGroup/Vulkan-Tutorial#544 ·
維護者通常 1 天內回覆
-
Clarify front-face culling when using a negative viewport height可能已有人在做 @1sgtpepper 於 18 天前認領。 未關閉
難度 2/5 1-3 小時 新手友好度 72/100
KhronosGroup/Vulkan-Tutorial#534 ·
維護者通常 1 天內回覆
-
Stale GLSL-specific wording in the Vertex Input Description chapter可能已有人在做 @gpx1000 於 27 天前認領。 未關閉
難度 2/5 1-3 小時 新手友好度 65/100
KhronosGroup/Vulkan-Tutorial#528 · 已指派 1 人 ·
維護者通常 1 天內回覆
-
Clarify vertex input bindings可能已有人在做 @SaschaWillems 於 27 天前認領。 未關閉
難度 2/5 1-3 小時 新手友好度 78/100
KhronosGroup/Vulkan-Tutorial#527 · 已指派 1 人 ·
維護者通常 1 天內回覆
查看 KhronosGroup/Vulkan-Tutorial 的全部 Issue
相似的 Issue
-
Documentation: Fix parameter markup, legacy branch link, and phrasing in Detachable Joints and Model Command tutorials可能已有人在做 @patelshivani2283-lab 今天認領。 未關閉
難度 1/5 1-3 小時 新手友好度 88/100
維護者通常 1 天內回覆
-
難度 2/5 1-3 小時 新手友好度 68/100
維護者通常 1 天內回覆
-
bug
難度 2/5 1-3 小時 新手友好度 82/100
-
難度 2/5 1-3 小時 新手友好度 75/100
Niko1221/Strata#6071 · 2 則留言 ·
維護者通常 4 天內回覆
-
pump未關閉
難度 1/5 1 小時以內 新手友好度 68/100
dewenni/ESP_Buderus_KM271#191 ·