better explanation of why we want zero-init

gen/gen.go

@@ -568,7 +568,7 @@ func (g *Generator) DefaultValue(member ParameterType, isDocString bool) string
 			return ref("WGPU_" + ConstantCase(typ) + "_INIT")
 		} else if *member.Default == "zero" {
 			if isDocString {
-				return "zero (so the entry is `BindingNotUsed`)"
+				return "zero (which sets the entry to `BindingNotUsed`)"
 			} else {
 				return literal("_wgpu_STRUCT_ZERO_INIT")
 			}

schema.json

@@ -160,7 +160,7 @@
                         "number",
                         "boolean"
                     ],
-                    "description": "Default value assigned to this parameter when using initializer macro"
+                    "description": "Default value assigned to this parameter when using initializer macro. Special context-dependent values include constant names (`constant.*`), bitflag names (unprefixed), and `zero` for struct-zero-init (where zero-init is known to have the desired result)."
                 }
             },
             "required": [

webgpu.h

@@ -3423,19 +3423,19 @@ typedef struct WGPUBindGroupLayoutEntry {
      */
     WGPUShaderStage visibility;
     /**
-     * The `INIT` macro sets this to zero (so the entry is `BindingNotUsed`).
+     * The `INIT` macro sets this to zero (which sets the entry to `BindingNotUsed`).
      */
     WGPUBufferBindingLayout buffer;
     /**
-     * The `INIT` macro sets this to zero (so the entry is `BindingNotUsed`).
+     * The `INIT` macro sets this to zero (which sets the entry to `BindingNotUsed`).
      */
     WGPUSamplerBindingLayout sampler;
     /**
-     * The `INIT` macro sets this to zero (so the entry is `BindingNotUsed`).
+     * The `INIT` macro sets this to zero (which sets the entry to `BindingNotUsed`).
      */
     WGPUTextureBindingLayout texture;
     /**
-     * The `INIT` macro sets this to zero (so the entry is `BindingNotUsed`).
+     * The `INIT` macro sets this to zero (which sets the entry to `BindingNotUsed`).
      */
     WGPUStorageTextureBindingLayout storageTexture;
 } WGPUBindGroupLayoutEntry WGPU_STRUCTURE_ATTRIBUTE;

webgpu.yml

@@ -1618,21 +1618,33 @@ structs:
         doc: |
           TODO
         type: struct.buffer_binding_layout
+        # Use struct-zero-init here to get .type=BindingNotUsed (0), instead of
+        # Undefined which is the default in WGPU_BUFFER_BINDING_LAYOUT_INIT.
+        # Zero-init is conveniently correct for the rest of the fields, too.
         default: zero
       - name: sampler
         doc: |
           TODO
         type: struct.sampler_binding_layout
+        # Use struct-zero-init here to get .type=BindingNotUsed (0), instead of
+        # Undefined which is the default in WGPU_SAMPLER_BINDING_LAYOUT_INIT.
+        # Zero-init is conveniently correct for the rest of the fields, too.
         default: zero
       - name: texture
         doc: |
           TODO
         type: struct.texture_binding_layout
+        # Use struct-zero-init here to get .sampleType=BindingNotUsed (0), instead of
+        # Undefined which is the default in WGPU_TEXTURE_BINDING_LAYOUT_INIT.
+        # Zero-init is conveniently correct for the rest of the fields, too.
         default: zero
       - name: storage_texture
         doc: |
           TODO
         type: struct.storage_texture_binding_layout
+        # Use struct-zero-init here to get .access=BindingNotUsed (0), instead of
+        # Undefined which is the default in WGPU_STORAGE_TEXTURE_BINDING_LAYOUT_INIT.
+        # Zero-init is conveniently correct for the rest of the fields, too.
         default: zero
   - name: blend_component
     doc: |