clarification

examples/shader/custom_phase_item.rs

@@ -280,9 +280,10 @@ struct CustomPhaseSpecializer;
 
 #[derive(Resource)]
 struct CustomPhasePipeline {
-    /// Holds a reference to our shader.
-    _shader: Handle<Shader>,
     specialized_cache: SpecializedCache<RenderPipeline, CustomPhaseSpecializer>,
+    /// the base_descriptor holds onto the shader handle, this field is
+    /// unused but here for demonstration purposes.
+    _shader: Handle<Shader>,
 }
 
 impl FromWorld for CustomPhasePipeline {

release-content/migration-guides/composable_specialization.md

@@ -145,11 +145,13 @@ After:
 ```rust
 #[derive(Resource)]
 pub struct MyPipeline {
+    specialized_cache: SpecializedCache<RenderPipeline, MySpecializer>,
+
+    // these fields are unused, they're just here for demonstration purposes
     layout: BindGroupLayout,
     layout_msaa: BindGroupLayout,
     vertex: Handle<Shader>,
     fragment: Handle<Shader>,
-    specialized_cache: SpecializedCache<RenderPipeline, MySpecializer>,
 }
 
 pub struct MySpecializer {