Consider moving the pipeline barrier explanation closer to where the parameters are set
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 72/100
- issue の種類
- ドキュメント
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- cpp
調査の方向性
リンク先のチュートリアルページにある Layout transitions と Transition barrier masks のセクションを読み、pipelineBarrier() のパラメーターの説明箇所と、それらのマスクの設定箇所を比較してください。提案どおりに説明を移動または簡潔にまとめ、読者が使用箇所と合わせて詳細を確認できるようにしてください。前のセクションでマスクについては後で説明すると簡潔に触れ、詳しい説明が 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 ファイルなし
- プルリクエストのテンプレートなし
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- 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 ·