Consider moving the pipeline barrier explanation closer to where the parameters are set
Los mantenedores suelen responder en 1 día
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 2/5
- Tiempo estimado
- 1-3 horas
- Aptitud para principiantes
- 72/100
- Tipo de issue
- Documentación
- Claridad
- Bien especificado
- Estado de actividad
- Activo
- Stack tecnológico
- cpp
- Área
- documentation
Línea de trabajo
Lee las secciones Layout transitions y Transition barrier masks de la página del tutorial enlazada y compara dónde se explican los parámetros de pipelineBarrier() con dónde se establecen sus máscaras. Mueve o condensa la explicación según lo propuesto para que los lectores encuentren los detalles junto con su uso; se considera terminado cuando la sección anterior indica brevemente que las máscaras se explican más adelante y la explicación detallada aparece en Transition barrier masks.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
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.
- Lenguaje dominante
- C++
- Estrellas
- 444
- Forks
- 145
- Métricas de merge de PR
- Sin PR fusionados en 30 d
Preparar el entorno
- Sin Dockerfile ni archivo de Docker Compose
- Sin plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de KhronosGroup/Vulkan-Tutorial
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 85/100
KhronosGroup/Vulkan-Tutorial#545 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 1/5 1-3 horas Aptitud para principiantes 76/100
KhronosGroup/Vulkan-Tutorial#544 ·
Los mantenedores suelen responder en 1 día
-
Clarify front-face culling when using a negative viewport heightPosiblemente ocupada @1sgtpepper la tomó hace 18 días. Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
KhronosGroup/Vulkan-Tutorial#534 ·
Los mantenedores suelen responder en 1 día
-
Stale GLSL-specific wording in the Vertex Input Description chapterPosiblemente ocupada @gpx1000 la tomó hace 27 días. Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 65/100
KhronosGroup/Vulkan-Tutorial#528 · 1 asignado ·
Los mantenedores suelen responder en 1 día
-
Clarify vertex input bindingsPosiblemente ocupada @SaschaWillems la tomó hace 27 días. Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
KhronosGroup/Vulkan-Tutorial#527 · 1 asignado ·
Los mantenedores suelen responder en 1 día
Todos los issues de KhronosGroup/Vulkan-Tutorial
Issues similares
-
Documentation: Fix parameter markup, legacy branch link, and phrasing in Detachable Joints and Model Command tutorialsPosiblemente ocupada @patelshivani2283-lab la tomó hoy. Abierto
Dificultad 1/5 1-3 horas Aptitud para principiantes 88/100
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
Los mantenedores suelen responder en 1 día
-
bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
Niko1221/Strata#6071 · 2 comentarios ·
Los mantenedores suelen responder en 4 días
-
pumpAbierto
Dificultad 1/5 Menos de una hora Aptitud para principiantes 68/100
dewenni/ESP_Buderus_KM271#191 ·