KhronosGroup · gpx1000 · Jan 13, 2026 · Jan 12, 2026 · Jan 12, 2026 · Jan 12, 2026
diff --git a/antora-ci-playbook.yml b/antora-ci-playbook.yml
@@ -12,3 +12,6 @@ content:
 ui:
   bundle:
     url: ui-bundle.zip
+runtime:
+  log:
+    failure_level: warn
diff --git a/antora/modules/ROOT/nav.adoc b/antora/modules/ROOT/nav.adoc
@@ -63,3 +63,89 @@
 ** xref:courses/18_Ray_tracing/07_Conclusion.adoc[Conclusion]
 * xref:90_FAQ.adoc[FAQ]
 * link:https://github.com/KhronosGroup/Vulkan-Tutorial[GitHub Repository, window=_blank]
+
+* Building a Simple Engine
+** xref:Building_a_Simple_Engine/introduction.adoc[Introduction]
+** Engine Architecture
+*** xref:Building_a_Simple_Engine/Engine_Architecture/01_introduction.adoc[Introduction]
+*** xref:Building_a_Simple_Engine/Engine_Architecture/02_architectural_patterns.adoc[Architectural patterns]
+*** xref:Building_a_Simple_Engine/Engine_Architecture/03_component_systems.adoc[Component systems]
+*** xref:Building_a_Simple_Engine/Engine_Architecture/04_resource_management.adoc[Resource management]
+*** xref:Building_a_Simple_Engine/Engine_Architecture/05_rendering_pipeline.adoc[Rendering pipeline]
+*** xref:Building_a_Simple_Engine/Engine_Architecture/06_event_systems.adoc[Event systems]
+*** xref:Building_a_Simple_Engine/Engine_Architecture/conclusion.adoc[Conclusion]
+** Camera Transformations
+*** xref:Building_a_Simple_Engine/Camera_Transformations/01_introduction.adoc[Introduction]
+*** xref:Building_a_Simple_Engine/Camera_Transformations/02_math_foundations.adoc[Math foundations]
+*** xref:Building_a_Simple_Engine/Camera_Transformations/03_transformation_matrices.adoc[Transformation matrices]
+*** xref:Building_a_Simple_Engine/Camera_Transformations/04_camera_implementation.adoc[Camera implementation]
+*** xref:Building_a_Simple_Engine/Camera_Transformations/05_vulkan_integration.adoc[Vulkan integration]
+*** xref:Building_a_Simple_Engine/Camera_Transformations/06_conclusion.adoc[Conclusion]
+** Lighting & Materials
+*** xref:Building_a_Simple_Engine/Lighting_Materials/01_introduction.adoc[Introduction]
+*** xref:Building_a_Simple_Engine/Lighting_Materials/02_lighting_models.adoc[Lighting models]
+*** xref:Building_a_Simple_Engine/Lighting_Materials/03_push_constants.adoc[Push constants]
+*** xref:Building_a_Simple_Engine/Lighting_Materials/04_lighting_implementation.adoc[Lighting implementation]
+*** xref:Building_a_Simple_Engine/Lighting_Materials/05_vulkan_integration.adoc[Vulkan integration]
+*** xref:Building_a_Simple_Engine/Lighting_Materials/07_shadows.adoc[Shadows]
+*** xref:Building_a_Simple_Engine/Lighting_Materials/06_conclusion.adoc[Conclusion]
+** GUI
+*** xref:Building_a_Simple_Engine/GUI/01_introduction.adoc[Introduction]
+*** xref:Building_a_Simple_Engine/GUI/02_imgui_setup.adoc[ImGui setup]
+*** xref:Building_a_Simple_Engine/GUI/03_input_handling.adoc[Input handling]
+*** xref:Building_a_Simple_Engine/GUI/04_ui_elements.adoc[UI elements]
+*** xref:Building_a_Simple_Engine/GUI/05_vulkan_integration.adoc[Vulkan integration]
+*** xref:Building_a_Simple_Engine/GUI/06_conclusion.adoc[Conclusion]
+** Loading Models
+*** xref:Building_a_Simple_Engine/Loading_Models/01_introduction.adoc[Introduction]
+*** xref:Building_a_Simple_Engine/Loading_Models/02_project_setup.adoc[Project setup]
+*** xref:Building_a_Simple_Engine/Loading_Models/03_model_system.adoc[Model system]
+*** xref:Building_a_Simple_Engine/Loading_Models/04_loading_gltf.adoc[Loading glTF]
+*** xref:Building_a_Simple_Engine/Loading_Models/05_pbr_rendering.adoc[PBR rendering]
+*** xref:Building_a_Simple_Engine/Loading_Models/06_multiple_objects.adoc[Multiple objects]
+*** xref:Building_a_Simple_Engine/Loading_Models/07_scene_rendering.adoc[Scene rendering]
+*** xref:Building_a_Simple_Engine/Loading_Models/08_animations.adoc[Animations]
+*** xref:Building_a_Simple_Engine/Loading_Models/09_conclusion.adoc[Conclusion]
+** Subsystems
+*** xref:Building_a_Simple_Engine/Subsystems/01_introduction.adoc[Introduction]
+*** xref:Building_a_Simple_Engine/Subsystems/02_audio_basics.adoc[Audio basics]
+*** xref:Building_a_Simple_Engine/Subsystems/03_vulkan_audio.adoc[Vulkan audio]
+*** xref:Building_a_Simple_Engine/Subsystems/04_physics_basics.adoc[Physics basics]
+*** xref:Building_a_Simple_Engine/Subsystems/05_vulkan_physics.adoc[Vulkan physics]
+*** xref:Building_a_Simple_Engine/Subsystems/06_conclusion.adoc[Conclusion]
+** Tooling
+*** xref:Building_a_Simple_Engine/Tooling/01_introduction.adoc[Introduction]
+*** xref:Building_a_Simple_Engine/Tooling/02_cicd.adoc[CI/CD]
+*** xref:Building_a_Simple_Engine/Tooling/03_debugging_and_renderdoc.adoc[Debugging & RenderDoc]
+*** xref:Building_a_Simple_Engine/Tooling/04_crash_minidump.adoc[Crash minidumps]
+*** xref:Building_a_Simple_Engine/Tooling/05_extensions.adoc[Extensions]
+*** xref:Building_a_Simple_Engine/Tooling/06_packaging_and_distribution.adoc[Packaging & distribution]
+*** xref:Building_a_Simple_Engine/Tooling/07_conclusion.adoc[Conclusion]
+** Mobile Development
+*** xref:Building_a_Simple_Engine/Mobile_Development/01_introduction.adoc[Introduction]
+*** xref:Building_a_Simple_Engine/Mobile_Development/02_platform_considerations.adoc[Platform considerations]
+*** xref:Building_a_Simple_Engine/Mobile_Development/03_performance_optimizations.adoc[Performance optimizations]
+*** xref:Building_a_Simple_Engine/Mobile_Development/04_rendering_approaches.adoc[Rendering approaches]
+*** xref:Building_a_Simple_Engine/Mobile_Development/05_vulkan_extensions.adoc[Vulkan extensions]
+*** xref:Building_a_Simple_Engine/Mobile_Development/06_conclusion.adoc[Conclusion]
+** Advanced Topics
+*** xref:Building_a_Simple_Engine/Advanced_Topics/01_introduction.adoc[Introduction]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Rendering_Pipeline_Overview.adoc[Rendering pipeline overview]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Forward_ForwardPlus_Deferred.adoc[Forward vs Forward+ vs Deferred]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/ForwardPlus_Rendering.adoc[Forward+ rendering]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Culling.adoc[Culling]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Mipmaps_and_LOD.adoc[Mipmaps & LOD]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Push_Constants_Per_Object.adoc[Push constants per object]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Synchronization_and_Streaming.adoc[Synchronization & streaming]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Synchronization_2_Frame_Pacing.adoc[Synchronization2 & frame pacing]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Descriptor_Indexing_UpdateAfterBind.adoc[Descriptor indexing (UpdateAfterBind)]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Separate_Image_Sampler_Descriptors.adoc[Separate image/sampler descriptors]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Shader_Tile_Image.adoc[Shader tile image]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/GLTF_Animation.adoc[glTF animation]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Planar_Reflections.adoc[Planar reflections]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Ray_Query_Rendering.adoc[Ray query rendering]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Ray_Query_Reflections_and_Transparency.adoc[Ray query: reflections & transparency]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Dynamic_Rendering_Local_Read.adoc[Dynamic rendering local read]
+*** xref:Building_a_Simple_Engine/Advanced_Topics/Robustness2.adoc[Robustness2]
+** Appendix
+*** xref:Building_a_Simple_Engine/Appendix/appendix.adoc[Appendix]
diff --git a/en/Building_a_Simple_Engine/Advanced_Topics/01_introduction.adoc b/en/Building_a_Simple_Engine/Advanced_Topics/01_introduction.adoc
@@ -6,22 +6,22 @@ Welcome — this section collects short, conversational guides that explain what
 
 Start anywhere that matches your interest:
 
-* link:Planar_Reflections.adoc[Planar Reflections]
-* link:Ray_Query_Rendering.adoc[Ray Query Rendering]
-* link:Ray_Query_Reflections_and_Transparency.adoc[Ray Query Reflections and Transparency]
-* link:Rendering_Pipeline_Overview.adoc[Rendering Pipeline Overview]
-* link:Forward_ForwardPlus_Deferred.adoc[Forward, Forward+, Deferred]
-* link:ForwardPlus_Rendering.adoc[Forward+ Rendering]
-* link:Culling.adoc[Frustum Culling and Distance LOD]
-* link:Mipmaps_and_LOD.adoc[Mipmaps and LOD]
-* link:GLTF_Animation.adoc[glTF Animation & Transform Composition]
-* link:Push_Constants_Per_Object.adoc[Push Constants (per‑object material)]
-* link:Descriptor_Indexing_UpdateAfterBind.adoc[Descriptor Indexing & Stable Updates]
-* link:Separate_Image_Sampler_Descriptors.adoc[Separate Image/Sampler]
-* link:Synchronization_and_Streaming.adoc[Synchronization & Streaming]
-* link:Synchronization_2_Frame_Pacing.adoc[Synchronization 2 & Frame Pacing]
-* link:Robustness2.adoc[VK_EXT_robustness2]
-* link:Dynamic_Rendering_Local_Read.adoc[Dynamic Rendering Local Read]
-* link:Shader_Tile_Image.adoc[Shader Tile Image]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Planar_Reflections.adoc[Planar Reflections]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Ray_Query_Rendering.adoc[Ray Query Rendering]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Ray_Query_Reflections_and_Transparency.adoc[Ray Query Reflections and Transparency]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Rendering_Pipeline_Overview.adoc[Rendering Pipeline Overview]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Forward_ForwardPlus_Deferred.adoc[Forward, Forward+, Deferred]
+* xref:Building_a_Simple_Engine/Advanced_Topics/ForwardPlus_Rendering.adoc[Forward+ Rendering]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Culling.adoc[Frustum Culling and Distance LOD]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Mipmaps_and_LOD.adoc[Mipmaps and LOD]
+* xref:Building_a_Simple_Engine/Advanced_Topics/GLTF_Animation.adoc[glTF Animation & Transform Composition]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Push_Constants_Per_Object.adoc[Push Constants (per‑object material)]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Descriptor_Indexing_UpdateAfterBind.adoc[Descriptor Indexing & Stable Updates]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Separate_Image_Sampler_Descriptors.adoc[Separate Image/Sampler]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Synchronization_and_Streaming.adoc[Synchronization & Streaming]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Synchronization_2_Frame_Pacing.adoc[Synchronization 2 & Frame Pacing]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Robustness2.adoc[VK_EXT_robustness2]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Dynamic_Rendering_Local_Read.adoc[Dynamic Rendering Local Read]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Shader_Tile_Image.adoc[Shader Tile Image]
 
-link:../index.html[Back to Building a Simple Engine]
+xref:Building_a_Simple_Engine/introduction.adoc[Back to Building a Simple Engine]
diff --git a/en/Building_a_Simple_Engine/Advanced_Topics/Culling.adoc b/en/Building_a_Simple_Engine/Advanced_Topics/Culling.adoc
@@ -41,6 +41,6 @@ If you want to push this further:
 
 == What to read next
 
-* `Rendering_Pipeline_Overview.adoc`
-* `ForwardPlus_Rendering.adoc`
-* `Ray_Query_Rendering.adoc`
+* xref:Building_a_Simple_Engine/Advanced_Topics/Rendering_Pipeline_Overview.adoc[Rendering Pipeline Overview]
+* xref:Building_a_Simple_Engine/Advanced_Topics/ForwardPlus_Rendering.adoc[Forward+ Rendering]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Ray_Query_Rendering.adoc[Ray Query Rendering]
diff --git a/...ilding_a_Simple_Engine/Advanced_Topics/Descriptor_Indexing_UpdateAfterBind.adoc b/...ilding_a_Simple_Engine/Advanced_Topics/Descriptor_Indexing_UpdateAfterBind.adoc
@@ -66,8 +66,8 @@ If you want to explore more advanced descriptor patterns:
 
 == What to read next
 
-* `Synchronization_and_Streaming.adoc`
-* `Separate_Image_Sampler_Descriptors.adoc`
-* `Ray_Query_Rendering.adoc`
+* xref:Building_a_Simple_Engine/Advanced_Topics/Synchronization_and_Streaming.adoc[Synchronization and Stremaing]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Separate_Image_Sampler_Descriptors.adoc[Separate Image Sampler Descriptors]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Ray_Query_Rendering.adoc[Ray Query Rendering]
 
 This conservative approach avoids common pitfalls while keeping the code approachable.
diff --git a/en/Building_a_Simple_Engine/Advanced_Topics/Dynamic_Rendering_Local_Read.adoc b/en/Building_a_Simple_Engine/Advanced_Topics/Dynamic_Rendering_Local_Read.adoc
@@ -34,6 +34,6 @@ If you want to demonstrate local-read more directly:
 
 == What to read next
 
-* `Rendering_Pipeline_Overview.adoc`
-* `Synchronization_and_Streaming.adoc`
-* `Synchronization_2_Frame_Pacing.adoc`
+* xref:Building_a_Simple_Engine/Advanced_Topics/Rendering_Pipeline_Overview.adoc[Rendering Pipelne Overview]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Synchronization_and_Streaming.adoc[Synchronization and Streaming]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Synchronization_2_Frame_Pacing.adoc[Frame Pacing]
diff --git a/en/Building_a_Simple_Engine/Advanced_Topics/ForwardPlus_Rendering.adoc b/en/Building_a_Simple_Engine/Advanced_Topics/ForwardPlus_Rendering.adoc
@@ -32,6 +32,6 @@ If you want to take this beyond a compact sample:
 
 == What to read next
 
-* `Forward_ForwardPlus_Deferred.adoc`
-* `Rendering_Pipeline_Overview.adoc`
-* `Synchronization_2_Frame_Pacing.adoc`
+* xref:Building_a_Simple_Engine/Advanced_Topics/Forward_ForwardPlus_Deferred.adoc[Forward+ deferred rendering]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Rendering_Pipeline_Overview.adoc[Rendering Pipeline Overview]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Synchronization_2_Frame_Pacing.adoc[Frame Pacing]
diff --git a/en/Building_a_Simple_Engine/Advanced_Topics/Forward_ForwardPlus_Deferred.adoc b/en/Building_a_Simple_Engine/Advanced_Topics/Forward_ForwardPlus_Deferred.adoc
@@ -97,6 +97,6 @@ If you want to expand the lighting system beyond “readable sample”:
 
 == What to read next
 
-* `Rendering_Pipeline_Overview.adoc`
-* `ForwardPlus_Rendering.adoc`
-* `Synchronization_2_Frame_Pacing.adoc`
+* xref:Building_a_Simple_Engine/Advanced_Topics/Rendering_Pipeline_Overview.adoc[Rendering Pipeline Overview]
+* xref:Building_a_Simple_Engine/Advanced_Topics/ForwardPlus_Rendering.adoc[Forward+ Rendering]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Synchronization_2_Frame_Pacing.adoc[Frame Pacing]
diff --git a/en/Building_a_Simple_Engine/Advanced_Topics/GLTF_Animation.adoc b/en/Building_a_Simple_Engine/Advanced_Topics/GLTF_Animation.adoc
@@ -251,7 +251,7 @@ return glm::slerp(q0, q1, t);  // Avoids gimbal lock
 If you want to dive deeper:
 
 * **Transform Component**: See `transform_component.h` for how we store and compute model matrices
-* **GLTF Specification**: https://registry.khronos.org/glTF/specs/2.0/glTF-2.0.html#animations
+* **GLTF Specification**: link:https://registry.khronos.org/glTF/specs/2.0/glTF-2.0.html#animations[GLTF Specification about animation]
 * **Synchronization**: How animation updates interact with render frame timing
 
 The key takeaway: **Always compose animation transforms with base transforms**. This fundamental principle is what makes objects animate in their correct world positions while the animation data itself describes relative changes. Understanding this composition is essential for any animation system.

diff --git a/en/Building_a_Simple_Engine/Advanced_Topics/Mipmaps_and_LOD.adoc b/en/Building_a_Simple_Engine/Advanced_Topics/Mipmaps_and_LOD.adoc
@@ -34,6 +34,6 @@ If you want to take this farther:
 
 == What to read next
 
-* `Descriptor_Indexing_UpdateAfterBind.adoc`
-* `Synchronization_and_Streaming.adoc`
-* `Ray_Query_Rendering.adoc`
+* xref:Building_a_Simple_Engine/Advanced_Topics/Descriptor_Indexing_UpdateAfterBind.adoc[Descriptor Indexing UpdateAfterBind]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Synchronization_and_Streaming.adoc[Synchronization and Streaming]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Ray_Query_Rendering.adoc[Ray Query Rendering]
diff --git a/en/Building_a_Simple_Engine/Advanced_Topics/Planar_Reflections.adoc b/en/Building_a_Simple_Engine/Advanced_Topics/Planar_Reflections.adoc
@@ -152,9 +152,9 @@ If you want to push planar reflections further:
 
 If you’re curious about the rest of this sample:
 
-* link:Synchronization_and_Streaming.adoc[Synchronization and Streaming]
-* link:ForwardPlus_Rendering.adoc[Forward+ Rendering]
-* link:Descriptor_Indexing_UpdateAfterBind.adoc[Descriptor Indexing and Stable Descriptor Updates]
-* link:Rendering_Pipeline_Overview.adoc[Rendering Pipeline Overview]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Synchronization_and_Streaming.adoc[Synchronization and Streaming]
+* xref:Building_a_Simple_Engine/Advanced_Topics/ForwardPlus_Rendering.adoc[Forward+ Rendering]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Descriptor_Indexing_UpdateAfterBind.adoc[Descriptor Indexing and Stable Descriptor Updates]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Rendering_Pipeline_Overview.adoc[Rendering Pipeline Overview]
 
 Enjoy experimenting. This approach is intentionally straightforward so you can focus on learning Vulkan’s moving parts without getting lost in a maze of techniques.
diff --git a/en/Building_a_Simple_Engine/Advanced_Topics/Push_Constants_Per_Object.adoc b/en/Building_a_Simple_Engine/Advanced_Topics/Push_Constants_Per_Object.adoc
@@ -34,6 +34,6 @@ If you want to extend this pattern:
 
 == What to read next
 
-* `Rendering_Pipeline_Overview.adoc`
-* `Descriptor_Indexing_UpdateAfterBind.adoc`
-* `Ray_Query_Rendering.adoc`
+* xref:Building_a_Simple_Engine/Advanced_Topics/Rendering_Pipeline_Overview.adoc[Rendering Pipeline Overview]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Descriptor_Indexing_UpdateAfterBind.adoc[Descriptor Indexing UpdateAfterBind]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Ray_Query_Rendering.adoc[Ray Query Rendering]
diff --git a/en/Building_a_Simple_Engine/Advanced_Topics/Robustness2.adoc b/en/Building_a_Simple_Engine/Advanced_Topics/Robustness2.adoc
@@ -46,6 +46,6 @@ If you want to stress-test robustness (without turning the engine into a debuggi
 
 == What to read next
 
-* `Synchronization_and_Streaming.adoc`
-* `Descriptor_Indexing_UpdateAfterBind.adoc`
-* `Ray_Query_Rendering.adoc`
+* xref:Building_a_Simple_Engine/Advanced_Topics/Synchronization_and_Streaming.adoc[Synchronization and Streaming]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Descriptor_Indexing_UpdateAfterBind.adoc[Descriptor Indexing UpdateAfterBind]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Ray_Query_Rendering.adoc[Ray Query Rendering]
diff --git a/...uilding_a_Simple_Engine/Advanced_Topics/Separate_Image_Sampler_Descriptors.adoc b/...uilding_a_Simple_Engine/Advanced_Topics/Separate_Image_Sampler_Descriptors.adoc
@@ -37,6 +37,6 @@ If you want to demonstrate separate image/sampler descriptors concretely:
 
 == What to read next
 
-* `Descriptor_Indexing_UpdateAfterBind.adoc`
-* `Mipmaps_and_LOD.adoc`
-* `Synchronization_and_Streaming.adoc`
+* xref:Building_a_Simple_Engine/Advanced_Topics/Descriptor_Indexing_UpdateAfterBind.adoc[Descriptor Indexing UpdateAfterBind]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Mipmaps_and_LOD.adoc[Mipmaps and LOD]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Synchronization_and_Streaming.adoc[Synchronization and Streaming]
diff --git a/en/Building_a_Simple_Engine/Advanced_Topics/Shader_Tile_Image.adoc b/en/Building_a_Simple_Engine/Advanced_Topics/Shader_Tile_Image.adoc
@@ -35,6 +35,6 @@ If you want to demonstrate tile-image usage more directly:
 
 == What to read next
 
-* `Dynamic_Rendering_Local_Read.adoc`
-* `Synchronization_2_Frame_Pacing.adoc`
-* `Rendering_Pipeline_Overview.adoc`
+* xref:Building_a_Simple_Engine/Advanced_Topics/Dynamic_Rendering_Local_Read.adoc[Dynamic Rendering Local Read]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Synchronization_2_Frame_Pacing.adoc[Frame Pacing]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Rendering_Pipeline_Overview.adoc[Rendering Pipeline Overview]
diff --git a/en/Building_a_Simple_Engine/Advanced_Topics/Synchronization_2_Frame_Pacing.adoc b/en/Building_a_Simple_Engine/Advanced_Topics/Synchronization_2_Frame_Pacing.adoc
@@ -60,6 +60,6 @@ If you want to experiment with pacing and latency:
 
 == What to read next
 
-* `Synchronization_and_Streaming.adoc`
-* `Descriptor_Indexing_UpdateAfterBind.adoc`
-* `Rendering_Pipeline_Overview.adoc`
+* xref:Building_a_Simple_Engine/Advanced_Topics/Synchronization_and_Streaming.adoc[Synchronization and Streaming]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Descriptor_Indexing_UpdateAfterBind.adoc[Descriptor Indexing UpdateAfterBind]
+* xref:Building_a_Simple_Engine/Advanced_Topics/Rendering_Pipeline_Overview.adoc[Rendering Pipeline Overview]
diff --git a/en/Building_a_Simple_Engine/Appendix/appendix.adoc b/en/Building_a_Simple_Engine/Appendix/appendix.adoc
@@ -335,5 +335,5 @@ When designing your engine architecture, consider:
 3. *Team Size and Experience* - More complex architectures may be harder to work with for smaller teams.
 4. *Project Scope* - A small project may not need the complexity of a full ECS.
 
-link:../Engine_Architecture/02_architectural_patterns.adoc[Back to Architectural Patterns]
-link:../Engine_Architecture/05_rendering_pipeline.adoc[Back to Rendering Pipeline]
+xref:Building_a_Simple_Engine/Engine_Architecture/02_architectural_patterns.adoc[Back to Architectural Patterns]
+xref:Building_a_Simple_Engine/Engine_Architecture/05_rendering_pipeline.adoc[Back to Rendering Pipeline]