Merge pull request #48212 from dotnet/main

Merge main into live

Author: dotnet-policy-service[bot]

docs/ai/media/mcp/available-tools.png

@@ -93,10 +93,12 @@ Complete the following steps to create a console app that connects to the `gpt-4
 
 1. And instead of requesting just the analyzed enumeration value, you can request the text response along with the analyzed value.
 
-   Define a record type to contain the text response and analyzed sentiment:
+   Define a [record type](../../csharp/language-reference/builtin-types/record.md) to contain the text response and analyzed sentiment:
 
    :::code language="csharp" source="./snippets/structured-output/Program.cs" id="InputOutputRecord":::
 
+   (This record type is defined using [primary constructor](../../csharp/programming-guide/classes-and-structs/instance-constructors.md#primary-constructors) syntax. Primary constructors combine the type definition with the parameters necessary to instantiate any instance of the class. The C# compiler generates public properties for the primary constructor parameters.)
+
    Send the request using the record type as the type argument to `GetResponseAsync<T>`:
 
    :::code language="csharp" source="./snippets/structured-output/Program.cs" id="RecordRequest":::

docs/ai/quickstarts/structured-output.md

@@ -57,7 +57,7 @@ If you wish to enable the previous behavior, which isn't recommended due to secu
 
 You can also set the `ASPNETCORE_FORWARDEDHEADERS_ENABLED` environment variable to `true`, which clears the lists and enables `ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto`.
 
-For applications that target .NET 9 or earlier, you can set the `Microsoft.AspNetCore.HttpOverrides.IgnoreUnknownProxiesWithoutFor` [AppContext](/dotnet/fundamentals/runtime-libraries/system-appcontext) switch to `"true"` or `1` to get back to the previous behavior. Alternatively, set the `MICROSOFT_ASPNETCORE_HTTPOVERRIDES_IGNORE_UNKNOWN_PROXIES_WITHOUT_FOR` environment variable.
+For applications that target .NET 9 or earlier, you can set the `Microsoft.AspNetCore.HttpOverrides.IgnoreUnknownProxiesWithoutFor` [AppContext](../../../../fundamentals/runtime-libraries/system-appcontext.md) switch to `"true"` or `1` to get back to the previous behavior. Alternatively, set the `MICROSOFT_ASPNETCORE_HTTPOVERRIDES_IGNORE_UNKNOWN_PROXIES_WITHOUT_FOR` environment variable.
 
 > [!NOTE]
 > In cloud environments, the proxy IPs can change over the lifetime of the app, and `ASPNETCORE_FORWARDEDHEADERS_ENABLED` is sometimes used to make forwarded headers work.

docs/core/compatibility/aspnet-core/8.0/forwarded-headers-unknown-proxies.md

@@ -29,7 +29,7 @@ This change is a [behavioral change](../../categories.md#behavioral-change).
 
 ## Reason for change
 
-<xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> serialization is obsolete in .NET 8 and later versions. Any use of <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> is deamed unsecure and throws an exception at run time. Since MSBuild custom derived build events use <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter>, your build would crash if you use these events in your build. The new build error provides a more graceful failure.
+<xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> serialization is obsolete in .NET 8 and later versions. Any use of <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> is deemed insecure and throws an exception at run time. Since MSBuild custom derived build events use <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter>, your build would crash if you used these events in your build. The new build error provides a more graceful failure.
 
 ## Recommended action
 

docs/core/compatibility/sdk/8.0/custombuildeventargs.md

@@ -58,7 +58,7 @@ public class TestClass1
 }
 ```
 
-Alternatively, you can configure cooperative cancellation globally in your [runsettings](/dotnet/core/testing/unit-testing-mstest-configure#mstest-element) or [testconfig.json](/dotnet/core/testing/unit-testing-mstest-configure#timeout-settings) file to apply this setting to all timeout attributes in your test project.
+Alternatively, you can configure cooperative cancellation globally in your [runsettings](../unit-testing-mstest-configure.md#mstest-element) or [testconfig.json](../unit-testing-mstest-configure.md#timeout-settings) file to apply this setting to all timeout attributes in your test project.
 
 ## When to suppress warnings
 

docs/core/deploying/includes/cli-r-rid-optional.md

@@ -12,4 +12,8 @@ ms.assetid: 106b9994-c762-44b9-942e-5417cf3dbbab
 
 Assuming assembly reference "Assembly Name #1" matches "Assembly Name #2", you may need to supply runtime policy
 
- The two assembly references have differing build and/or revision numbers, so will not automatically unify. You may need to supply run-time policy to force unification by `using` directives in the application .config file.
+ The two assembly references have differing build and/or revision numbers, so will not automatically unify. You may need to supply run-time policy to force unification by `using` directives in the application [.config file](../../framework/configure-apps/index.md#application-configuration-files).
+
+## See also
+
+- [Configuration File Schema](../../framework/configure-apps/file-schema/application-settings-schema.md)