Confusing and frustrating "Development Environment" chapter — mixing general Vulkan setup with tutorial-specific scripts
Les mainteneurs répondent en général sous 16 jours
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 2/5
- Temps estimé
- 1-3 heures
- Accessibilité débutants
- 76/100
- Type d'issue
- Documentation
- Clarté
- Clairement spécifiée
- Activité
- Active
- Stack technique
- cpp
- Domaine
- documentation
Piste de recherche
Lis le chapitre « Development Environment » dans 02_Development_environment et repère où la configuration générale du Vulkan SDK est mêlée à la configuration du dépôt propre au tutoriel et aux scripts de dépendances. Sépare ces instructions et précise que le clonage du dépôt et l’exécution des scripts sont facultatifs pour les personnes qui disposent déjà d’un projet C++ et d’une configuration GLFW/GLM. Le chapitre sera terminé lorsqu’il présentera clairement les deux parcours de configuration et les étapes facultatives.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
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.
- Langage dominant
- C++
- Étoiles
- 444
- Forks
- 145
- Merge moyen
- 12 j 10 h
- PR mergées (30 j)
- 12
Préparer son environnement
- Aucun Dockerfile ni fichier Docker Compose
- Aucun modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de KhronosGroup/Vulkan-Tutorial
-
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
KhronosGroup/Vulkan-Tutorial#551 ·
Les mainteneurs répondent en général sous 16 jours
-
Difficulté 1/5 Moins d'une heure Accessibilité débutants 85/100
KhronosGroup/Vulkan-Tutorial#545 ·
Les mainteneurs répondent en général sous 16 jours
-
Difficulté 1/5 1-3 heures Accessibilité débutants 76/100
KhronosGroup/Vulkan-Tutorial#544 ·
Les mainteneurs répondent en général sous 16 jours
-
Clarify front-face culling when using a negative viewport heightPeut-être pris @1sgtpepper l’a pris il y a 19 jours. Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
KhronosGroup/Vulkan-Tutorial#534 ·
Les mainteneurs répondent en général sous 16 jours
-
Clarify vertex input bindingsPeut-être à nouveau libre @SaschaWillems l’a pris il y a 28 jours, et aucune pull request n’est ouverte. Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
KhronosGroup/Vulkan-Tutorial#527 · 1 personne assignée ·
Les mainteneurs répondent en général sous 16 jours
Toutes les issues de KhronosGroup/Vulkan-Tutorial
Issues similaires
-
Reference check: findingsOuverteaudit-reference-check
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 76/100
schrodinger/pymol-open-source#532 ·
-
Difficulté 2/5 1-3 heures Accessibilité débutants 70/100
-
Difficulté 1/5 Moins d'une heure Accessibilité débutants 83/100
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 1/5 Moins d'une heure Accessibilité débutants 82/100
Les mainteneurs répondent en général sous 1 jour