Confusing and frustrating "Development Environment" chapter — mixing general Vulkan setup with tutorial-specific scripts
Maintainer antworten meist innerhalb von 16 Tagen
Dieses Issue hat noch niemand übernommen.
Bewertung
- Schwierigkeit
- 2/5
- Geschätzter Aufwand
- 1-3 Stunden
- Anfängerfreundlichkeit
- 76/100
- Issue-Typ
- Dokumentation
- Klarheit
- Klar beschrieben
- Aktivitätsstatus
- Aktiv
- Tech-Stack
- cpp
- Bereich
- documentation
Rechercherichtung
Lies das Kapitel „Development Environment“ in 02_Development_environment und ermittle, an welchen Stellen die allgemeine Vulkan-SDK-Einrichtung mit der tutorialspezifischen Einrichtung des Repositorys und den Abhängigkeitsskripten vermischt ist. Trenne diese Anweisungen und stelle klar, dass das Klonen des Repositorys und das Ausführen der Skripte für Nutzer mit einem vorhandenen C++-Projekt und einer GLFW/GLM-Einrichtung optional sind. Fertig ist die Aufgabe, wenn das Kapitel die beiden Einrichtungswege und die optionalen Schritte klar darstellt.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
In the "Development Environment" chapter (02_Development_environment), the documentation promises to "set up your environment for developing Vulkan applications", yet immediately forces the user to clone the entire Vulkan-Tutorial repository and run system-wide Dependency Install Scripts (install_dependencies_windows.bat / install_dependencies_linux.sh).
This is extremely confusing and frustrating for newcomers:
- Misleading structure: Setting up a general Vulkan environment (installing the Vulkan SDK and a compiler) is mixed up with setting up dependencies for this specific tutorial's codebase.
- Risky and fragile scripts: If a developer already has the Vulkan SDK, an IDE, and libraries like GLFW/GLM configured, running opaque system-wide installation scripts is completely unnecessary. Worse, these scripts are fragile, easily break depending on the user's environment, and waste hours of debugging time just to get started.
Suggestion:
Please clearly separate the general Vulkan SDK setup from the tutorial-specific template/dependencies, and state upfront that cloning the repo and running install scripts are strictly optional if the user already has a working C++ project with GLFW/GLM.
- Vorherrschende Sprache
- C++
- Sterne
- 444
- Forks
- 145
- Ø Merge
- 12 T. 10 Std.
- Gemergte PRs (30 T.)
- 12
Entwicklungsumgebung
- Kein Dockerfile und keine Docker-Compose-Datei
- Keine Pull-Request-Vorlage
- Beitragsleitfaden lesen
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus KhronosGroup/Vulkan-Tutorial
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100
KhronosGroup/Vulkan-Tutorial#551 ·
Maintainer antworten meist innerhalb von 16 Tagen
-
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 85/100
KhronosGroup/Vulkan-Tutorial#545 ·
Maintainer antworten meist innerhalb von 16 Tagen
-
Schwierigkeit 1/5 1-3 Stunden Anfängerfreundlichkeit 76/100
KhronosGroup/Vulkan-Tutorial#544 ·
Maintainer antworten meist innerhalb von 16 Tagen
-
Clarify front-face culling when using a negative viewport heightEvtl. vergeben @1sgtpepper hat das vor 20 Tagen übernommen. Offen
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100
KhronosGroup/Vulkan-Tutorial#534 ·
Maintainer antworten meist innerhalb von 16 Tagen
-
Clarify vertex input bindingsEvtl. wieder frei @SaschaWillems hat das vor 29 Tagen übernommen, und es ist kein Pull Request offen. Offen
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
KhronosGroup/Vulkan-Tutorial#527 · 1 zugewiesene Person ·
Maintainer antworten meist innerhalb von 16 Tagen
Alle Issues in KhronosGroup/Vulkan-Tutorial
Ähnliche Issues
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 71/100
ROCm/rocm-libraries#16108 ·
Maintainer antworten meist innerhalb von 2 Tagen
-
asr pass bug intrinsic low priority wrong result
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 67/100
Maintainer antworten meist innerhalb von 1 Tag
-
👀 needs triage enhancement
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100
rerun-io/rerun#13021 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 2 Tagen
-
bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100
Maintainer antworten meist innerhalb von 2 Tagen
-
audit-reference-check
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
Maintainer antworten meist innerhalb von 1 Tag