diff --git a/ci/header_order_smoke/consumer.h b/ci/header_order_smoke/consumer.h
index fd5f46a..6676754 100644
--- a/ci/header_order_smoke/consumer.h
+++ b/ci/header_order_smoke/consumer.h
@@ -1,3 +1,4 @@
+// Fails compilation if a dependent C header is included before the pinned Vulkan core.
 #ifndef VK_HEADER_VERSION
 #error "Pinned Vulkan headers must precede consumer includes"
 #endif
diff --git a/ci/header_order_smoke/consumer/consumer.c.v b/ci/header_order_smoke/consumer/consumer.c.v
index e516cec..7c5efe8 100644
--- a/ci/header_order_smoke/consumer/consumer.c.v
+++ b/ci/header_order_smoke/consumer/consumer.c.v
@@ -1,3 +1,4 @@
+// Imports a dependent C header to test Vulkan core ordering across V modules.
 module consumer
 
 #include "@VMODROOT/ci/header_order_smoke/consumer.h"
diff --git a/ci/header_order_smoke/main.c.v b/ci/header_order_smoke/main.c.v
index 2aa96cc..f64fcf8 100644
--- a/ci/header_order_smoke/main.c.v
+++ b/ci/header_order_smoke/main.c.v
@@ -1,3 +1,4 @@
+// Confirms a dependent module sees the same pinned Vulkan header version as the bindings.
 module main
 
 import ci.header_order_smoke.consumer