Update `dotnet` command documentation for new file-based app functionality

[baronfel]

Type of issue

Other (describe below)

Description

Describe the issue or suggestion

Several commands have learned to handle the new file-based apps feature in .NET 10:

• clean
• build
• run
• publish
• restore

In addition, there are new utility commands that act as tooling helpers for the new feature

• run-api
• clean file-based apps subcommands

We need to go through the existing articles and

• document the behavior change to the implicit "project, solution or file" argument
• add any new options that exist to support the file-based apps feature
• add examples for using the new feature

We may also want to have a dedicated roll-up page for file-based apps to capture the nuances of how they work and describe the defaults they opt-in to - @DamianEdwards thoughts?

C# Doc reference: https://learn.microsoft.com/en-us/dotnet/csharp/fundamentals/tutorials/file-based-programs

Page URL

https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-clean

Content source URL

https://github.com/dotnet/docs/blob/live/docs/core/tools/dotnet-clean.md

Document Version Independent Id

fad3d9a6-f1e8-7428-84cf-7895ece1efa2

Article author

adegeo

Metadata

• ID: ce4a4413-002d-4f6b-547d-3ac0c2cf84b8
• Service: dotnet-fundamentals

---

Associated WorkItem - 491808

[gewarren]

@tdykstra Will you handle this or do you want me to?