Merge pull request #52624 from dotnet/main

Merge main into live

Author: dotnet-policy-service[bot]

docs/ai/snippets/prompt-engineering/multi-turn-chat.cs

@@ -13,7 +13,7 @@
         .AsAIAgent();
 
 // Create a session to maintain conversation state.
-AgentSession session = await agent.GetNewSessionAsync();
+AgentSession session = await agent.CreateSessionAsync();
 
 while (true)
 {

docs/ai/snippets/prompt-engineering/multi-turn-chat.csproj

@@ -10,7 +10,7 @@
 
   <ItemGroup>
     <PackageReference Include="Azure.AI.OpenAI" Version="2.8.0-beta.1" />
-    <PackageReference Include="Microsoft.Agents.AI.OpenAI" Version="1.0.0-preview.260128.1" />
+    <PackageReference Include="Microsoft.Agents.AI.OpenAI" Version="1.0.0-rc4" />
     <!--
     <PackageReference Include="Microsoft.Extensions.Configuration" Version="10.0.2" />
     <PackageReference Include="Microsoft.Extensions.Configuration.UserSecrets" Version="10.0.2" />

docs/azure/includes/dotnet-all.md

@@ -36,7 +36,7 @@
 | Conversational Language Understanding | NuGet [1.1.0](https://www.nuget.org/packages/Azure.AI.Language.Conversations/1.1.0)<br>NuGet [2.0.0-beta.5](https://www.nuget.org/packages/Azure.AI.Language.Conversations/2.0.0-beta.5) | [docs](/dotnet/api/overview/azure/AI.Language.Conversations-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Language.Conversations_1.1.0/sdk/cognitivelanguage/Azure.AI.Language.Conversations/)<br>GitHub [2.0.0-beta.5](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Language.Conversations_2.0.0-beta.5/sdk/cognitivelanguage/Azure.AI.Language.Conversations/) |
 | Conversations Authoring | NuGet [1.0.0-beta.3](https://www.nuget.org/packages/Azure.AI.Language.Conversations.Authoring/1.0.0-beta.3) | [docs](/dotnet/api/overview/azure/AI.Language.Conversations.Authoring-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [1.0.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Language.Conversations.Authoring_1.0.0-beta.3/sdk/cognitivelanguage/Azure.AI.Language.Conversations.Authoring/) |
 | Core - Client - AMQP | NuGet [1.3.1](https://www.nuget.org/packages/Azure.Core.Amqp/1.3.1) | [docs](/dotnet/api/overview/azure/Core.Amqp-readme) | GitHub [1.3.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Core.Amqp_1.3.1/sdk/core/Azure.Core.Amqp/) |
-| Core - Client - Core | NuGet [1.51.1](https://www.nuget.org/packages/Azure.Core/1.51.1) | [docs](/dotnet/api/overview/azure/Core-readme) | GitHub [1.51.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Core_1.51.1/sdk/core/Azure.Core/) |
+| Core - Client - Core | NuGet [1.52.0](https://www.nuget.org/packages/Azure.Core/1.52.0) | [docs](/dotnet/api/overview/azure/Core-readme) | GitHub [1.52.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Core_1.52.0/sdk/core/Azure.Core/) |
 | Core - Client - Core | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Core.Expressions.DataFactory/1.0.0) | [docs](/dotnet/api/overview/azure/Core.Expressions.DataFactory-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Core.Expressions.DataFactory_1.0.0/sdk/core/Azure.Core.Expressions.DataFactory/) |
 | Core Newtonsoft Json | NuGet [2.0.0](https://www.nuget.org/packages/Microsoft.Azure.Core.NewtonsoftJson/2.0.0) | [docs](/dotnet/api/overview/azure/Microsoft.Azure.Core.NewtonsoftJson-readme) | GitHub [2.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.Core.NewtonsoftJson_2.0.0/sdk/core/Microsoft.Azure.Core.NewtonsoftJson/) |
 | Core WCF Storage Queues | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Microsoft.CoreWCF.Azure.StorageQueues/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Microsoft.CoreWCF.Azure.StorageQueues-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.CoreWCF.Azure.StorageQueues_1.0.0-beta.1/sdk/extension-wcf/Microsoft.CoreWCF.Azure.StorageQueues/) |
@@ -115,12 +115,12 @@
 | Schema Registry | NuGet [1.4.0](https://www.nuget.org/packages/Azure.Data.SchemaRegistry/1.4.0) | [docs](/dotnet/api/overview/azure/Data.SchemaRegistry-readme) | GitHub [1.4.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Data.SchemaRegistry_1.4.0/sdk/schemaregistry/Azure.Data.SchemaRegistry/) |
 | Schema Registry - Avro | NuGet [1.0.1](https://www.nuget.org/packages/Microsoft.Azure.Data.SchemaRegistry.ApacheAvro/1.0.1) | [docs](/dotnet/api/overview/azure/Microsoft.Azure.Data.SchemaRegistry.ApacheAvro-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.Data.SchemaRegistry.ApacheAvro_1.0.1/sdk/schemaregistry/Microsoft.Azure.Data.SchemaRegistry.ApacheAvro/) |
 | Service Bus | NuGet [7.20.1](https://www.nuget.org/packages/Azure.Messaging.ServiceBus/7.20.1) | [docs](/dotnet/api/overview/azure/Messaging.ServiceBus-readme) | GitHub [7.20.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Messaging.ServiceBus_7.20.1/sdk/servicebus/Azure.Messaging.ServiceBus/) |
-| Storage - Blobs | NuGet [12.27.0](https://www.nuget.org/packages/Azure.Storage.Blobs/12.27.0)<br>NuGet [12.28.0-beta.1](https://www.nuget.org/packages/Azure.Storage.Blobs/12.28.0-beta.1) | [docs](/dotnet/api/overview/azure/Storage.Blobs-readme) | GitHub [12.27.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Blobs_12.27.0/sdk/storage/Azure.Storage.Blobs/)<br>GitHub [12.28.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Blobs_12.28.0-beta.1/sdk/storage/Azure.Storage.Blobs/) |
-| Storage - Blobs Batch | NuGet [12.24.0](https://www.nuget.org/packages/Azure.Storage.Blobs.Batch/12.24.0)<br>NuGet [12.25.0-beta.1](https://www.nuget.org/packages/Azure.Storage.Blobs.Batch/12.25.0-beta.1) | [docs](/dotnet/api/overview/azure/Storage.Blobs.Batch-readme) | GitHub [12.24.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Blobs.Batch_12.24.0/sdk/storage/Azure.Storage.Blobs.Batch/)<br>GitHub [12.25.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Blobs.Batch_12.25.0-beta.1/sdk/storage/Azure.Storage.Blobs.Batch/) |
-| Storage - Blobs ChangeFeed | NuGet [12.0.0-preview.60](https://www.nuget.org/packages/Azure.Storage.Blobs.ChangeFeed/12.0.0-preview.60) | [docs](/dotnet/api/overview/azure/Storage.Blobs.ChangeFeed-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [12.0.0-preview.60](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Blobs.ChangeFeed_12.0.0-preview.60/sdk/storage/Azure.Storage.Blobs.ChangeFeed/) |
-| Storage - Files Data Lake | NuGet [12.25.0](https://www.nuget.org/packages/Azure.Storage.Files.DataLake/12.25.0)<br>NuGet [12.26.0-beta.1](https://www.nuget.org/packages/Azure.Storage.Files.DataLake/12.26.0-beta.1) | [docs](/dotnet/api/overview/azure/Storage.Files.DataLake-readme) | GitHub [12.25.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Files.DataLake_12.25.0/sdk/storage/Azure.Storage.Files.DataLake/)<br>GitHub [12.26.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Files.DataLake_12.26.0-beta.1/sdk/storage/Azure.Storage.Files.DataLake/) |
-| Storage - Files Share | NuGet [12.25.0](https://www.nuget.org/packages/Azure.Storage.Files.Shares/12.25.0)<br>NuGet [12.26.0-beta.1](https://www.nuget.org/packages/Azure.Storage.Files.Shares/12.26.0-beta.1) | [docs](/dotnet/api/overview/azure/Storage.Files.Shares-readme) | GitHub [12.25.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Files.Shares_12.25.0/sdk/storage/Azure.Storage.Files.Shares/)<br>GitHub [12.26.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Files.Shares_12.26.0-beta.1/sdk/storage/Azure.Storage.Files.Shares/) |
-| Storage - Queues | NuGet [12.25.0](https://www.nuget.org/packages/Azure.Storage.Queues/12.25.0)<br>NuGet [12.26.0-beta.1](https://www.nuget.org/packages/Azure.Storage.Queues/12.26.0-beta.1) | [docs](/dotnet/api/overview/azure/Storage.Queues-readme) | GitHub [12.25.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Queues_12.25.0/sdk/storage/Azure.Storage.Queues/)<br>GitHub [12.26.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Queues_12.26.0-beta.1/sdk/storage/Azure.Storage.Queues/) |
+| Storage - Blobs | NuGet [12.27.0](https://www.nuget.org/packages/Azure.Storage.Blobs/12.27.0)<br>NuGet [12.29.0-beta.1](https://www.nuget.org/packages/Azure.Storage.Blobs/12.29.0-beta.1) | [docs](/dotnet/api/overview/azure/Storage.Blobs-readme) | GitHub [12.27.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Blobs_12.27.0/sdk/storage/Azure.Storage.Blobs/)<br>GitHub [12.29.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Blobs_12.29.0-beta.1/sdk/storage/Azure.Storage.Blobs/) |
+| Storage - Blobs Batch | NuGet [12.24.0](https://www.nuget.org/packages/Azure.Storage.Blobs.Batch/12.24.0)<br>NuGet [12.26.0-beta.1](https://www.nuget.org/packages/Azure.Storage.Blobs.Batch/12.26.0-beta.1) | [docs](/dotnet/api/overview/azure/Storage.Blobs.Batch-readme) | GitHub [12.24.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Blobs.Batch_12.24.0/sdk/storage/Azure.Storage.Blobs.Batch/)<br>GitHub [12.26.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Blobs.Batch_12.26.0-beta.1/sdk/storage/Azure.Storage.Blobs.Batch/) |
+| Storage - Blobs ChangeFeed | NuGet [12.0.0-preview.61](https://www.nuget.org/packages/Azure.Storage.Blobs.ChangeFeed/12.0.0-preview.61) | [docs](/dotnet/api/overview/azure/Storage.Blobs.ChangeFeed-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [12.0.0-preview.61](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Blobs.ChangeFeed_12.0.0-preview.61/sdk/storage/Azure.Storage.Blobs.ChangeFeed/) |
+| Storage - Files Data Lake | NuGet [12.25.0](https://www.nuget.org/packages/Azure.Storage.Files.DataLake/12.25.0)<br>NuGet [12.27.0-beta.1](https://www.nuget.org/packages/Azure.Storage.Files.DataLake/12.27.0-beta.1) | [docs](/dotnet/api/overview/azure/Storage.Files.DataLake-readme) | GitHub [12.25.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Files.DataLake_12.25.0/sdk/storage/Azure.Storage.Files.DataLake/)<br>GitHub [12.27.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Files.DataLake_12.27.0-beta.1/sdk/storage/Azure.Storage.Files.DataLake/) |
+| Storage - Files Share | NuGet [12.25.0](https://www.nuget.org/packages/Azure.Storage.Files.Shares/12.25.0)<br>NuGet [12.27.0-beta.1](https://www.nuget.org/packages/Azure.Storage.Files.Shares/12.27.0-beta.1) | [docs](/dotnet/api/overview/azure/Storage.Files.Shares-readme) | GitHub [12.25.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Files.Shares_12.25.0/sdk/storage/Azure.Storage.Files.Shares/)<br>GitHub [12.27.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Files.Shares_12.27.0-beta.1/sdk/storage/Azure.Storage.Files.Shares/) |
+| Storage - Queues | NuGet [12.25.0](https://www.nuget.org/packages/Azure.Storage.Queues/12.25.0)<br>NuGet [12.27.0-beta.1](https://www.nuget.org/packages/Azure.Storage.Queues/12.27.0-beta.1) | [docs](/dotnet/api/overview/azure/Storage.Queues-readme) | GitHub [12.25.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Queues_12.25.0/sdk/storage/Azure.Storage.Queues/)<br>GitHub [12.27.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Queues_12.27.0-beta.1/sdk/storage/Azure.Storage.Queues/) |
 | Synapse - AccessControl | NuGet [1.0.0-preview.5](https://www.nuget.org/packages/Azure.Analytics.Synapse.AccessControl/1.0.0-preview.5) | [docs](/dotnet/api/overview/azure/Analytics.Synapse.AccessControl-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [1.0.0-preview.5](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Analytics.Synapse.AccessControl_1.0.0-preview.5/sdk/synapse/Azure.Analytics.Synapse.AccessControl/) |
 | Synapse - Artifacts | NuGet [1.0.0-preview.22](https://www.nuget.org/packages/Azure.Analytics.Synapse.Artifacts/1.0.0-preview.22) | [docs](/dotnet/api/overview/azure/Analytics.Synapse.Artifacts-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [1.0.0-preview.22](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Analytics.Synapse.Artifacts_1.0.0-preview.22/sdk/synapse/Azure.Analytics.Synapse.Artifacts/) |
 | Synapse - Managed Private Endpoints | NuGet [1.0.0-beta.5](https://www.nuget.org/packages/Azure.Analytics.Synapse.ManagedPrivateEndpoints/1.0.0-beta.5) | [docs](/dotnet/api/overview/azure/Analytics.Synapse.ManagedPrivateEndpoints-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [1.0.0-beta.5](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Analytics.Synapse.ManagedPrivateEndpoints_1.0.0-beta.5/sdk/synapse/Azure.Analytics.Synapse.ManagedPrivateEndpoints/) |
@@ -150,7 +150,7 @@
 | Functions extension for Azure Tables | NuGet [1.4.0](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.Tables/1.4.0) | [docs](/dotnet/api/overview/azure/Microsoft.Azure.WebJobs.Extensions.Tables-readme) | GitHub [1.4.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.WebJobs.Extensions.Tables_1.4.0/sdk/tables/Microsoft.Azure.WebJobs.Extensions.Tables/) |
 | Key Encryptor for .NET Data Protection | NuGet [1.6.1](https://www.nuget.org/packages/Azure.Extensions.AspNetCore.DataProtection.Keys/1.6.1) | [docs](/dotnet/api/overview/azure/Extensions.AspNetCore.DataProtection.Keys-readme) | GitHub [1.6.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Extensions.AspNetCore.DataProtection.Keys_1.6.1/sdk/extensions/Azure.Extensions.AspNetCore.DataProtection.Keys/) |
 | Secrets Configuration Provider for .NET | NuGet [1.5.0](https://www.nuget.org/packages/Azure.Extensions.AspNetCore.Configuration.Secrets/1.5.0) | [docs](/dotnet/api/overview/azure/Extensions.AspNetCore.Configuration.Secrets-readme) | GitHub [1.5.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Extensions.AspNetCore.Configuration.Secrets_1.5.0/sdk/extensions/Azure.Extensions.AspNetCore.Configuration.Secrets/) |
-| Storage - Common | NuGet [12.26.0](https://www.nuget.org/packages/Azure.Storage.Common/12.26.0)<br>NuGet [12.27.0-beta.1](https://www.nuget.org/packages/Azure.Storage.Common/12.27.0-beta.1) | [docs](/dotnet/api/overview/azure/Storage.Common-readme) | GitHub [12.26.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Common_12.26.0/sdk/storage/Azure.Storage.Common/)<br>GitHub [12.27.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Common_12.27.0-beta.1/sdk/storage/Azure.Storage.Common/) |
+| Storage - Common | NuGet [12.26.0](https://www.nuget.org/packages/Azure.Storage.Common/12.26.0)<br>NuGet [12.28.0-beta.1](https://www.nuget.org/packages/Azure.Storage.Common/12.28.0-beta.1) | [docs](/dotnet/api/overview/azure/Storage.Common-readme) | GitHub [12.26.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Common_12.26.0/sdk/storage/Azure.Storage.Common/)<br>GitHub [12.28.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Common_12.28.0-beta.1/sdk/storage/Azure.Storage.Common/) |
 | WebJobs Extensions - Event Grid | NuGet [3.5.0](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.EventGrid/3.5.0) | [docs](/dotnet/api/overview/azure/Microsoft.Azure.WebJobs.Extensions.EventGrid-readme) | GitHub [3.5.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.WebJobs.Extensions.EventGrid_3.5.0/sdk/eventgrid/Microsoft.Azure.WebJobs.Extensions.EventGrid/) |
 | WebJobs Extensions - Event Hubs | NuGet [6.5.3](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.EventHubs/6.5.3) | [docs](/dotnet/api/overview/azure/Microsoft.Azure.WebJobs.Extensions.EventHubs-readme) | GitHub [6.5.3](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.WebJobs.Extensions.EventHubs_6.5.3/sdk/eventhub/Microsoft.Azure.WebJobs.Extensions.EventHubs/) |
 | WebJobs Extensions - Service Bus | NuGet [5.17.0](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.ServiceBus/5.17.0) | [docs](/dotnet/api/overview/azure/Microsoft.Azure.WebJobs.Extensions.ServiceBus-readme) | GitHub [5.17.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.WebJobs.Extensions.ServiceBus_5.17.0/sdk/servicebus/Microsoft.Azure.WebJobs.Extensions.ServiceBus/) |

docs/azure/includes/dotnet-new.md

@@ -91,14 +91,20 @@ To run the application, the `dotnet run` command resolves the dependencies of th
 
   The path to the file-based app to run. If a path isn't specified, the current directory is used to find and run the file. For more information on file-based apps, see [Build file-based C# apps](../../csharp/fundamentals/tutorials/file-based-programs.md).
 
-  On Unix, you can run file-based apps directly, using the source file name on the command line instead of `dotnet run`. First, ensure the file has execute permissions. Then, add a shebang line `#!` as the first line of the file, for example:
-  
+  On Unix, you can execute file-based apps directly using the filename. This requires a shebang line `#!` as the first line of the file and the *execute* permission to be set. For example:
+
   ```csharp
-  #!/usr/bin/env dotnet run
+  #!/usr/bin/env dotnet
   ```
-  
-  Then you can run the file directly from the command line:
-  
+
+  Set the execute bit:
+
+  ```bash
+  chmod +x ConsoleApp.cs
+  ```
+
+  Now you can run the file directly from the command line:
+
   ```bash
   ./ConsoleApp.cs
   ```

docs/core/tools/dotnet-run.md

@@ -37,7 +37,7 @@ Starting with C# 14 and .NET 10, *file-based apps* let you run a program contain
 :::code language="csharp" source="./snippets/file-based-program/hello-world.cs":::
 
 > [!NOTE]
-> The `#!` line enables Unix shells to run the file directly. On any Unix system, set the *execute* (`+x`) permission and run the file from the command line.
+> The `#!` line enables Unix operating systems to execute the file directly (for example, `./hello-world.cs`). This requires the *execute* permission to be set (`chmod +x <file>`).
 
 File-based apps support all C# syntax and can use [preprocessor directives](../../language-reference/preprocessor-directives.md#file-based-apps) to configure the build system. Use file-based apps for small command-line utilities, prototypes, and experiments. A file-based app consists of a single file in a directory:
 

docs/csharp/fundamentals/program-structure/index.md

@@ -24,13 +24,13 @@ C# preprocessor directives tell the compiler what code to include, exclude, or t
 
 Starting with C# 14, [file-based apps](index.md) use two additional directives:
 
-- `#!` — the *shebang* line that lets Unix shells run the file directly (for example, `#!/usr/bin/env dotnet run`).
+- `#!` — the *shebang* line that enables executing the file directly on Unix (for example, `./Program.cs`). This requires the *execute* permission to be set on the file (`chmod +x <file>`).
 - `#:` — build-system directives that configure packages, SDK settings, and other options for single-file programs.
 
 Use `#:package` to add a NuGet package. For example, the following file-based app uses the `Spectre.Console` package to render styled output:
 
 ```csharp
-#!/usr/bin/env dotnet run
+#!/usr/bin/env dotnet
 #:package Spectre.Console@*
 
 AnsiConsole.MarkupLine("[bold green]Hello[/] from a file-based app!");

docs/csharp/fundamentals/program-structure/preprocessor-directives.md

@@ -39,7 +39,7 @@ The compiler generates a method to serve as the program entry point for a projec
 | `return`                | `static int Main(string[] args)`             |
 | No `await` or `return`  | `static void Main(string[] args)`            |
 
-Starting with C# 14, programs can be [*file-based apps*](./index.md#building-and-running-c-programs), where a single file contains the program. You run *file-based apps* by using the command `dotnet <file.cs>`, or by using the `#!/usr/bin/env dotnet` directive as the first line (Unix shells only).
+Starting with C# 14, programs can be [*file-based apps*](./index.md#building-and-running-c-programs), where a single file contains the program. You run *file-based apps* by using the command `dotnet <file.cs>`, or directly using the filename on Unix (for example, `./file.cs`). The latter requires including the `#!/usr/bin/env dotnet` directive as the first line and setting the execute permission (`chmod +x <file>`).
 
 ## `using` directives