search

Overv / VulkanTutorial

Tutorial for the Vulkan graphics and compute API
https://vulkan-tutorial.com
Creative Commons Attribution Share Alike 4.0 International
3.12k stars 513 forks source link

Suggestion: Include more infographics #162

Open MythreyaK opened 4 years ago

MythreyaK commented 4 years ago

The tutorial is really great and I finally managed to get a triangle on my screen! I would like to provide some feedback and suggestions.

Adding illustrations for how things interact will help one grasp the relation b/w code pieces more easily. One such example (I think it's the only one there) is from the official Vulkan tutorial. Looking at these images really helped me reason better about the code and gain a better understanding of how stuff works and more importantly, what I need to do to get something working.

It would also be nice if the code listing after each lesson had all the code added from this lesson highlighted, with perhaps a color that is, say 5-10% lighter/darker. This helps draw attention to the code modified, helping with focus.

The sidebar is great to navigate around, but for focusing on the content, it would help if the main content is centered in the screen. I'm not sure what design would be the best, but a simple hamburger-style slide-in-out sidebar would do fine.

Dark Mode, if possible 😁.

Thank you for the tutorial! Had a lot of fun so far!

mj-saunders commented 4 years ago

This was just shared with me on irc: vulkan api

mj-saunders commented 4 years ago

also found this: Understanding Vulkan Objects haven't gone through thoroughly yet, but looks useful