Restructure tutorial (navigation)

Open

#520 opened on Sep 19, 2026 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty: 5/5
Estimated time: Over a week
Newbie friendliness: 35/100

Issue type: Documentation
Clarity: Needs clarification
Activity status: Active
Tech stack: cpp
Domain: documentation

Research direction

Start by reviewing the tutorial's current navigation and the chapter sequence. Compare the “Migrating to Modern Asset Formats: glTF and KTX2” chapter with the simple engine and other referenced chapters to identify duplication. Done means an agreed navigation structure and clearly resolved decisions about duplicated or removable content.

Written by the indexing model from the issue text.

Description

There has been some recent criticism concerning the tutorials structure and with that, a lack of focus. With all of the recent additions, it's kinda hard for people new to Vulkan to actually find their way around. We should address this. A good first step would be cleaning up and/or reordering the navigation. We should also take a look at content duplication and maybe even think about removing certain chapters. E.g the "Migrating to Modern Asset Formats: glTF and KTX2" chapter is at partially covered/duplicated in other chapters like the simple engine.

Dominant language: C++
Stars: 424
Forks: 127
Avg merge: 2d 22h
Merged PRs (30d): 7

Contributor guide

Open the contributing guide

First steps

Read the whole issue, then the project's contributing guide.
Comment on the issue to say you are picking it up — it saves two people doing the same work.
Fork the repository and make your change on a branch.
Open a pull request that references the issue number.

Similar issues

Use 4:4:4 for multichannel AVIF and HEIF gain maps Open

Difficulty 2/5 1-3 hours Newbie friendliness 70/100

google/libultrahdr#485 · Opened Sep 24, 2026
Missing tile warnings in TileMap dock display with wrong texture filter Open

Difficulty 2/5 1-3 hours Newbie friendliness 75/100

godotengine/godot#123776 · Opened Sep 23, 2026
if(cond,a,b) treats any nonzero cond as true in every bngsim backend (ExprTk interpreter, C codegen, SSA), which contradicts docs/reference/expressions.md ('true when > 0.5') and BNG's run_network. A non-boolean condition in (-inf,0) or... Open

bug

Difficulty 1/5 Under an hour Newbie friendliness 60/100

lanl/bngsim#774 · Opened Sep 23, 2026
Delete ament_export_include_directories() and ament_export_libraries() calls Open

good first issue

Difficulty 1/5 Under an hour Newbie friendliness 90/100

ros2/rosbag2#2509 · Opened Sep 23, 2026
Delete ament_export_include_directories() and ament_export_libraries() calls Open

good first issue

Difficulty 2/5 1-3 hours Newbie friendliness 75/100

ros2/common_interfaces#344 · Opened Sep 23, 2026

More C++ issues