From 703082e2937cb798caca41bb09f260af20856526 Mon Sep 17 00:00:00 2001 From: Ahmet Ibrahim Aksoy Date: Mon, 24 Jun 2024 15:40:49 +0300 Subject: [PATCH 1/5] Addressing feedback on TLS Best Practices (#41495) --- docs/framework/network-programming/tls.md | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/docs/framework/network-programming/tls.md b/docs/framework/network-programming/tls.md index eb101b7678ee0..d03a20c470185 100644 --- a/docs/framework/network-programming/tls.md +++ b/docs/framework/network-programming/tls.md @@ -53,10 +53,15 @@ For more information see [TLS protocol version support in Schannel](/windows/win ## Recommendations -- For TLS 1.3, target .NET Framework 4.8 or later. -- Do not specify the TLS version explicitly. Configure your code to let the OS decide on the TLS version. +- For TLS 1.3, target .NET Framework 4.8 or later. ([here](#audit-your-code-and-make-code-changes) is how to check what is your `target framework`.) +- Do not specify the TLS version explicitly. (i.e. don't use the method overloads of SslStream that take an explicit SslProtocols parameter.) + - That way your code will let the OS decide on the TLS version. + - If you must set , then set it to . That will also use OS default. + - If you must use the method overloads of SslStream that take an explicit SslProtocols parameter, then pass `SslProtocols.SystemDefault` as argument. That will also use OS default. - Perform a thorough code audit to verify you're not specifying a TLS or SSL version explicitly. -- Do not use `SslProtocols.Default`. (`SslProtocols.Default` specifies SSL3 and TLS1.0 version which is obsoleted.) + +> [!WARNING] +> Do not use `SslProtocols.Default`. (because it sets TLS version to SSL3 and TLS1.0 which is obsoleted.) When your app lets the OS choose the TLS version: From c7ba67578f70ea45544978ff68ca64dab683f4fa Mon Sep 17 00:00:00 2001 From: McLean Schofield <11544635+mcleanbyron@users.noreply.github.com> Date: Mon, 24 Jun 2024 05:41:13 -0700 Subject: [PATCH 2/5] Added ms.collection for AI content tracking (#41526) --- docfx.json | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docfx.json b/docfx.json index 3e6de72486c5e..8466e2778f4c4 100644 --- a/docfx.json +++ b/docfx.json @@ -840,6 +840,10 @@ "docs/framework/**/*.md": "UpdateFrequency5", "docs/visual-basic/**/*.md": "UpdateFrequency5" }, + "ms.collection": { + "docs/ai/**/**.md": "ce-skilling-ai-copilot", + "docs/ai/**/**.yml": "ce-skilling-ai-copilot" + }, "no-loc": { "**/**.md": [ "Orleans" From 786945e50fb00268ef5da211d88a89e68431fd17 Mon Sep 17 00:00:00 2001 From: Azure SDK Bot <53356347+azure-sdk@users.noreply.github.com> Date: Mon, 24 Jun 2024 11:24:38 -0400 Subject: [PATCH 3/5] Update package index with latest published versions (#41537) --- docs/azure/includes/dotnet-all.md | 2 +- docs/azure/includes/dotnet-new.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/azure/includes/dotnet-all.md b/docs/azure/includes/dotnet-all.md index 9cc47655212bf..004c7c883e4ec 100644 --- a/docs/azure/includes/dotnet-all.md +++ b/docs/azure/includes/dotnet-all.md @@ -255,7 +255,7 @@ | Resource Management - Monitor | NuGet [1.3.1](https://www.nuget.org/packages/Azure.ResourceManager.Monitor/1.3.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Monitor-readme) | GitHub [1.3.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Monitor_1.3.1/sdk/monitor/Azure.ResourceManager.Monitor/) | | Resource Management - MySQL | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.MySql/1.0.1)
NuGet [1.1.0-beta.5](https://www.nuget.org/packages/Azure.ResourceManager.MySql/1.1.0-beta.5) | [docs](/dotnet/api/overview/azure/ResourceManager.MySql-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.MySql_1.0.1/sdk/mysql/Azure.ResourceManager.MySql/)
GitHub [1.1.0-beta.5](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.MySql_1.1.0-beta.5/sdk/mysql/Azure.ResourceManager.MySql/) | | Resource Management - NetApp Files | NuGet [1.5.0](https://www.nuget.org/packages/Azure.ResourceManager.NetApp/1.5.0) | [docs](/dotnet/api/overview/azure/ResourceManager.NetApp-readme) | GitHub [1.5.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.NetApp_1.5.0/sdk/netapp/Azure.ResourceManager.NetApp/) | -| Resource Management - Network | NuGet [1.7.0](https://www.nuget.org/packages/Azure.ResourceManager.Network/1.7.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Network-readme) | GitHub [1.7.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Network_1.7.0/sdk/network/Azure.ResourceManager.Network/) | +| Resource Management - Network | NuGet [1.8.0](https://www.nuget.org/packages/Azure.ResourceManager.Network/1.8.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Network-readme) | GitHub [1.8.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Network_1.8.0/sdk/network/Azure.ResourceManager.Network/) | | Resource Management - Network Analytics | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.NetworkAnalytics/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.NetworkAnalytics-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.NetworkAnalytics_1.0.0/sdk/networkanalytics/Azure.ResourceManager.NetworkAnalytics/) | | Resource Management - Network Cloud | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.NetworkCloud/1.0.1) | [docs](/dotnet/api/overview/azure/ResourceManager.NetworkCloud-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.NetworkCloud_1.0.1/sdk/networkcloud/Azure.ResourceManager.NetworkCloud/) | | Resource Management - Network Function | NuGet [1.0.0-beta.4](https://www.nuget.org/packages/Azure.ResourceManager.NetworkFunction/1.0.0-beta.4) | [docs](/dotnet/api/overview/azure/ResourceManager.NetworkFunction-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.NetworkFunction_1.0.0-beta.4/sdk/networkfunction/Azure.ResourceManager.NetworkFunction/) | diff --git a/docs/azure/includes/dotnet-new.md b/docs/azure/includes/dotnet-new.md index 58fc64c1014c2..be639e916de1d 100644 --- a/docs/azure/includes/dotnet-new.md +++ b/docs/azure/includes/dotnet-new.md @@ -261,7 +261,7 @@ | Resource Management - Monitor | NuGet [1.3.1](https://www.nuget.org/packages/Azure.ResourceManager.Monitor/1.3.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Monitor-readme) | GitHub [1.3.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Monitor_1.3.1/sdk/monitor/Azure.ResourceManager.Monitor/) | | Resource Management - MySQL | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.MySql/1.0.1)
NuGet [1.1.0-beta.5](https://www.nuget.org/packages/Azure.ResourceManager.MySql/1.1.0-beta.5) | [docs](/dotnet/api/overview/azure/ResourceManager.MySql-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.MySql_1.0.1/sdk/mysql/Azure.ResourceManager.MySql/)
GitHub [1.1.0-beta.5](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.MySql_1.1.0-beta.5/sdk/mysql/Azure.ResourceManager.MySql/) | | Resource Management - NetApp Files | NuGet [1.5.0](https://www.nuget.org/packages/Azure.ResourceManager.NetApp/1.5.0) | [docs](/dotnet/api/overview/azure/ResourceManager.NetApp-readme) | GitHub [1.5.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.NetApp_1.5.0/sdk/netapp/Azure.ResourceManager.NetApp/) | -| Resource Management - Network | NuGet [1.7.0](https://www.nuget.org/packages/Azure.ResourceManager.Network/1.7.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Network-readme) | GitHub [1.7.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Network_1.7.0/sdk/network/Azure.ResourceManager.Network/) | +| Resource Management - Network | NuGet [1.8.0](https://www.nuget.org/packages/Azure.ResourceManager.Network/1.8.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Network-readme) | GitHub [1.8.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Network_1.8.0/sdk/network/Azure.ResourceManager.Network/) | | Resource Management - Network Analytics | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.NetworkAnalytics/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.NetworkAnalytics-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.NetworkAnalytics_1.0.0/sdk/networkanalytics/Azure.ResourceManager.NetworkAnalytics/) | | Resource Management - Network Cloud | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.NetworkCloud/1.0.1) | [docs](/dotnet/api/overview/azure/ResourceManager.NetworkCloud-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.NetworkCloud_1.0.1/sdk/networkcloud/Azure.ResourceManager.NetworkCloud/) | | Resource Management - Network Function | NuGet [1.0.0-beta.4](https://www.nuget.org/packages/Azure.ResourceManager.NetworkFunction/1.0.0-beta.4) | [docs](/dotnet/api/overview/azure/ResourceManager.NetworkFunction-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.NetworkFunction_1.0.0-beta.4/sdk/networkfunction/Azure.ResourceManager.NetworkFunction/) | From 8b3e4cdb825ead32885e4acdff6b9e6fdaf98443 Mon Sep 17 00:00:00 2001 From: Bill Wagner Date: Mon, 24 Jun 2024 12:59:34 -0400 Subject: [PATCH 4/5] Remove extraneous note (#41536) Remove the note on `nameof`. It's in the wrong location, and the sample that uses `nameof` already has text noting that it's a C# 11 feature. --- docs/csharp/language-reference/attributes/nullable-analysis.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/docs/csharp/language-reference/attributes/nullable-analysis.md b/docs/csharp/language-reference/attributes/nullable-analysis.md index 573814fd04c93..88431c8202522 100644 --- a/docs/csharp/language-reference/attributes/nullable-analysis.md +++ b/docs/csharp/language-reference/attributes/nullable-analysis.md @@ -139,9 +139,6 @@ That informs the compiler that any code where the return value is `false` doesn' :::code language="csharp" source="snippets/NullableAttributes.cs" ID="NullCheckExample" ::: -> [!NOTE] -> The preceding example is only valid in C# 11 and later. Starting with C# 11, the [`nameof` expression](../operators/nameof.md) can reference parameter and type parameter names when used in an attribute applied to a method. In C# 10 and earlier, you need to use a string literal instead of the `nameof` expression. - The method will be annotated as shown above for .NET Core 3.0. You may have similar methods in your codebase that check the state of objects for null values. The compiler won't recognize custom null check methods, and you'll need to add the annotations yourself. When you add the attribute, the compiler's static analysis knows when the tested variable has been null checked. Another use for these attributes is the `Try*` pattern. The postconditions for `ref` and `out` arguments are communicated through the return value. Consider this method shown earlier (in a nullable disabled context): From 60451f507133ba8b4071db2d6ca862c01d9945a6 Mon Sep 17 00:00:00 2001 From: YuliiaKovalova <95473390+YuliiaKovalova@users.noreply.github.com> Date: Mon, 24 Jun 2024 19:06:01 +0200 Subject: [PATCH 5/5] Add information about riscv64 support in bash scripts (#41534) --- docs/core/tools/dotnet-install-script.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/tools/dotnet-install-script.md b/docs/core/tools/dotnet-install-script.md index 1f4b7dd7f9f7c..0f40492cc9543 100644 --- a/docs/core/tools/dotnet-install-script.md +++ b/docs/core/tools/dotnet-install-script.md @@ -95,7 +95,7 @@ The install scripts do not update the registry on Windows. They just download th - **`-Architecture|--architecture `** - Architecture of the .NET binaries to install. Possible values are ``, `amd64`, `x64`, `x86`, `arm64`, `arm`, `s390x`, and `ppc64le`. The default value is ``, which represents the currently running OS architecture. + Architecture of the .NET binaries to install. Possible values are ``, `amd64`, `x64`, `x86`, `arm64`, `arm`, `s390x`, `ppc64le`, and `riscv64`. The default value is ``, which represents the currently running OS architecture. - **`-AzureFeed|--azure-feed`**