docs: explain new example and test sources

README.md

@@ -71,6 +71,8 @@ names and reports an error if none are found. No window or shader tools are need
 
 <!-- example: examples/getting_started/main.v -->
 ```v
+// Lists Vulkan devices through the ergonomic instance owner with explicit cleanup.
+// Requires a Vulkan loader and device, but no window or shaders.
 module main
 
 import antono2.vulkan.ergonomic as vke

ergonomic/conveniences_test.v

@@ -1,3 +1,4 @@
+// Checks format masks, acquire outcomes and invalid descriptor/cache inputs without a driver.
 module ergonomic
 
 import antono2.vulkan as vk

examples/getting_started/main.v

@@ -1,3 +1,5 @@
+// Lists Vulkan devices through the ergonomic instance owner with explicit cleanup.
+// Requires a Vulkan loader and device, but no window or shaders.
 module main
 
 import antono2.vulkan.ergonomic as vke