Updates

Author: guardrex

aspnetcore/blazor/host-and-deploy/configure-trimmer.md

@@ -42,7 +42,7 @@ For more information, see [Trimming options (.NET documentation)](/dotnet/core/d
 
 ## Failure to preserve types used by a published app
 
-Trimming may have detrimental effects for a published app leading to runtime errors. In apps that use [reflection](/dotnet/csharp/advanced-topics/reflection-and-attributes/), the IL Trimmer often can't determine the required types for runtime reflection and trims them away. This can happen with complex framework types used for JS interop, JSON serialization/deserialization, and other operations.
+Trimming may have detrimental effects for a published app leading to runtime errors. In apps that use [reflection](/dotnet/csharp/advanced-topics/reflection-and-attributes/), the IL Trimmer often can't determine the required types for runtime reflection and trims them away or trims away parameter names from methods. This can happen with complex framework types used for JS interop, JSON serialization/deserialization, and other operations.
 
 Consider the following client-side component in a Blazor Web App (ASP.NET Core 8.0 or later) that deserializes a <xref:System.Collections.Generic.KeyValuePair> collection (`List<KeyValuePair<string, string>>`):
 
@@ -76,7 +76,7 @@ Consider the following client-side component in a Blazor Web App (ASP.NET Core 8
 }
 ```
 
-The preceding component executes normally when the app is run locally:
+The preceding component executes normally when the app is run locally and produces the following rendered definition list (`<dl>`):
 
 > **:::no-loc text="key 1":::**  
 > :::no-loc text="value 1":::  
@@ -100,26 +100,20 @@ public sealed class StringKeyValuePair(string key, string value)
 }
 ```
 
-The component is modified to use the `StringKeyValuePair` type. Because custom types are never trimmed by Blazor when an app is published, the component works as designed:
+The component is modified to use the `StringKeyValuePair` type:
 
-```razor
-@code {
-    private List<StringKeyValuePair> items = [];
-
-    [StringSyntax(StringSyntaxAttribute.Json)]
-    private const string data =
-        """[{"key":"key 1","value":"value 1"},{"key":"key 2","value":"value 2"}]""";
-
-    protected override void OnInitialized()
-    {
-        JsonSerializerOptions options = new() { PropertyNameCaseInsensitive = true };
+```diff
+- private List<KeyValuePair<string, string>> items = [];
++ private List<StringKeyValuePair> items = [];
+```
 
-        items = JsonSerializer
-            .Deserialize<List<StringKeyValuePair>>(data, options)!;
-    }
-}
+```diff
+- items = JsonSerializer.Deserialize<List<KeyValuePair<string, string>>>(data, options)!;
++ items = JsonSerializer.Deserialize<List<StringKeyValuePair>>(data, options)!;
 ```
 
+Because custom types are never trimmed by Blazor when an app is published, the component works as designed after the app is published.
+
 The IL Trimmer is also unable to react to an app's dynamic behavior at runtime. To ensure the trimmed app works correctly once deployed, test published output frequently while developing.
 
 ## Additional resources