apply changes from review feedback

Author: meaghanlewis

docs/core/tools/dotnet-build.md

@@ -9,7 +9,7 @@ ms.date: 09/24/2025
 
 ## Name
 
-`dotnet build` - Builds a project, solution, or file-based program and all of its dependencies.
+`dotnet build` - Builds a project, solution, or file-based app and all of its dependencies.
 
 ## Synopsis
 
@@ -32,7 +32,7 @@ dotnet build -h|--help
 
 ## Description
 
-The `dotnet build` command builds the project, solution, or file-based program and its dependencies into a set of binaries. The binaries include the project's code in Intermediate Language (IL) files with a *.dll* extension. Depending on the project type and settings, other files may be included, such as:
+The `dotnet build` command builds the project, solution, or file-based app and its dependencies into a set of binaries. The binaries include the project's code in Intermediate Language (IL) files with a *.dll* extension. Depending on the project type and settings, other files may be included, such as:
 
 - An executable that can be used to run the application.
 - Symbol files used for debugging with a *.pdb* extension.
@@ -62,7 +62,7 @@ To produce a library, omit the `<OutputType>` property or change its value to `L
 
 ### MSBuild
 
-`dotnet build` uses MSBuild to build the project, solution, or file-based program. It supports both parallel and incremental builds. For more information, see [Incremental Builds](/visualstudio/msbuild/incremental-builds).
+`dotnet build` uses MSBuild to build the project, solution, or file-based app. It supports both parallel and incremental builds. For more information, see [Incremental Builds](/visualstudio/msbuild/incremental-builds).
 
 In addition to its options, the `dotnet build` command accepts MSBuild options, such as `-p` for setting properties or `-l` to define a logger. For more information about these options, see the [MSBuild Command-Line Reference](/visualstudio/msbuild/msbuild-command-line-reference). Or you can also use the [dotnet msbuild](dotnet-msbuild.md) command.
 
@@ -77,13 +77,13 @@ Running `dotnet build` is equivalent to running `dotnet msbuild -restore`; howev
 
 `PROJECT | SOLUTION | FILE`
 
-The project or solution or C# (file-based program) file to publish. If a file isn't specified, MSBuild searches the current directory for a project or solution.
+The project or solution or C# (file-based app) file to build. If a file isn't specified, MSBuild searches the current directory for a project or solution.
 
 - `PROJECT` is the path and filename of a C#, F#, or Visual Basic project file, or the path to a directory that contains a C#, F#, or Visual Basic project file.
 
 - `SOLUTION` is the path and filename of a solution file (*.sln* or *.slnx* extension), or the path to a directory that contains a solution file.
 
-- `FILE` is an argument added in .NET 10. The path and filename of a file-based program. File-based programs are contained within a single `*.cs` file that are built and run without a corresponding project (`*.csproj`) file. For more information, see [Build file-based C# programs](/dotnet/csharp/fundamentals/tutorials/file-based-programs).
+- `FILE` is an argument added in .NET 10. The path and filename of a file-based app. File-based apps are contained within a single file that is built and run without a corresponding project (`*.csproj`) file. For more information, see [Build file-based C# programs](/dotnet/csharp/fundamentals/tutorials/file-based-programs).
 
 ## Options
 
@@ -180,13 +180,13 @@ The project or solution or C# (file-based program) file to publish. If a file is
   dotnet build
   ```
 
-- Build a file-based program:
+- Build a file-based app:
 
   ```dotnetcli
   dotnet build MyProject.cs
   ```
 
-  File-based program support was added in .NET SDK 10.0.100.
+  File-based app support was added in .NET SDK 10.0.100.
 
 - Build a project and its dependencies using Release configuration:
 

docs/core/tools/dotnet-clean.md

@@ -32,13 +32,13 @@ The `dotnet clean` command cleans the output of the previous build. It's impleme
 
 `PROJECT | SOLUTION | FILE`
 
-The project or solution or C# (file-based program) file to publish. If a file isn't specified, MSBuild searches the current directory for a project or solution.
+The project or solution or C# (file-based app) file to clean. If a file isn't specified, MSBuild searches the current directory for a project or solution.
 
 - `PROJECT` is the path and filename of a C#, F#, or Visual Basic project file, or the path to a directory that contains a C#, F#, or Visual Basic project file.
 
 - `SOLUTION` is the path and filename of a solution file (*.sln* or *.slnx* extension), or the path to a directory that contains a solution file.
 
-- `FILE` is an argument added in .NET 10. The path and filename of a file-based program. File-based programs are contained within a single `*.cs` file that are built and run without a corresponding project (`*.csproj`) file. For more information, see [Build file-based C# programs](/dotnet/csharp/fundamentals/tutorials/file-based-programs).
+- `FILE` is an argument added in .NET 10. The path and filename of a file-based app. File-based apps are contained within a single file that is built and run without a corresponding project (`*.csproj`) file. For more information, see [Build file-based C# apps](/dotnet/csharp/fundamentals/tutorials/file-based-programs).
 
 ## Options
 
@@ -88,7 +88,7 @@ The project or solution or C# (file-based program) file to publish. If a file is
   dotnet clean Program.cs.
   ```
 
-  File-based program support was added in .NET SDK 10.0.100.
+  File-based app support was added in .NET SDK 10.0.100.
 
 - Clean a project built using the Release configuration:
 

docs/core/tools/dotnet-publish.md

@@ -122,7 +122,7 @@ The project or solution or C# (file-based program) file to publish. If a file is
 
 - `SOLUTION` is the path and filename of a solution file (*.sln* or *.slnx* extension), or the path to a directory that contains a solution file.
 
-- `FILE` is an argument added in .NET 10. The path and filename of a file-based program. File-based programs are contained within a single `*.cs` file that are built and run without a corresponding project (`*.csproj`) file. For more information, see [Build file-based C# programs](/dotnet/csharp/fundamentals/tutorials/file-based-programs).
+- `FILE` is an argument added in .NET 10. The path and filename of a file-based app. File-based apps are contained within a single file that is built and run without a corresponding project (`*.csproj`) file. For more information, see [Build file-based C# apps](/dotnet/csharp/fundamentals/tutorials/file-based-programs).
 
 ## Options
 

docs/core/tools/dotnet-restore.md

@@ -88,13 +88,13 @@ There are three specific settings that `dotnet restore` ignores:
 
 `PROJECT | SOLUTION | FILE`
 
-The project or solution or C# (file-based program) file to restore. If a file isn't specified, MSBuild searches the current directory for a project or solution.
+The project or solution or C# (file-based app) file to restore. If a file isn't specified, MSBuild searches the current directory for a project or solution.
 
 - `PROJECT` is the path and filename of a C#, F#, or Visual Basic project file, or the path to a directory that contains a C#, F#, or Visual Basic project file. If the directory is not specified, it defaults to the current directory.
 
 - `SOLUTION` is the path and filename of a solution file (*.sln* or *.slnx* extension), or the path to a directory that contains a solution file. If the directory is not specified, it defaults to the current directory.
 
-- `FILE` is an argument added in .NET 10. The path and filename of a file-based program. File-based programs are contained within a single `*.cs` file that are built and run without a corresponding project (`*.csproj`) file. For more information, see [Build file-based C# programs](/dotnet/csharp/fundamentals/tutorials/file-based-programs).
+- `FILE` is an argument added in .NET 10. The path and filename of a file-based app. File-based apps are contained within a single file that is built and run without a corresponding project (`*.csproj`) file. For more information, see [Build file-based C# apps](/dotnet/csharp/fundamentals/tutorials/file-based-programs).
 
 ## Options
 

docs/core/tools/dotnet-run.md

@@ -83,7 +83,19 @@ To run the application, the `dotnet run` command resolves the dependencies of th
 
 - **`--file <FILE_PATH>`**
 
-  The path to the file-based program to run. This option can be passed as the first argument if there is no project in the current directory.  For more information, see [Build file-based C# programs](/dotnet/csharp/fundamentals/tutorials/file-based-programs).
+  The path to the file-based app to run. This option can be passed as the first argument if there is no project in the current directory. For more information, see [Build file-based C# apps](/dotnet/csharp/fundamentals/tutorials/file-based-programs).
+  
+  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:
+  
+  ```csharp
+  #!/usr/bin/env dotnet run
+  ```
+  
+  Then you can run the file directly from the command line:
+  
+  ```bash
+  ./ConsoleApp.cs
+  ```
 
   Introduced in .NET SDK 10.0.100.
 
@@ -167,13 +179,13 @@ The environment is constructed in the same order as this list, so the `-e|--envi
   dotnet run
   ```
 
-- Run the specified file-based program with arguments:
+- Run the specified file-based app with arguments:
 
   ```dotnetcli
   dotnet run ConsoleApp.cs -- arg1 arg2
   ```
 
-  File-based program support was added in .NET SDK 10.0.100.
+  File-based app support was added in .NET SDK 10.0.100.
 
 - Run the specified project: