Clarify file-based apps documentation per PR feedback

[Copilot]

Addresses technical inaccuracies and missing clarifications in the file-based apps documentation identified during PR review.

Changes

• Package versioning: Added note that omitting version in #:package Newtonsoft.Json requires central package management (Directory.Packages.props)

• Argument passing: Removed incorrect guidance suggesting dotnet run file.cs arg1 arg2 passes arguments to the app (they go to dotnet run itself)

• ResX files: Clarified ResX files are only included in non-default SDKs, not by default

• Build cache: Removed --no-cache flag documentation as it's not needed with dotnet build file.cs

Example

Before, the package directive section didn't explain when versionless references work:

#:package Newtonsoft.Json
#:package Serilog@3.1.1

Now includes:

Note: Omitting the version number after the package name currently only works when you use central package management with a Directory.Packages.props file. Otherwise, specify the version number explicitly, or add @* after the package name to use the latest version.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Clarify information in file-based apps</issue_title>
<issue_description>### Type of issue

Outdated article

Description

• ResX files are only included in non-default SDKs. Update file-based apps reference article #50604 (comment)
• Add a note that not specifying a version currently only works with central package management (Directory.Packages.props). Update file-based apps reference article #50604 (comment)
• Remove the part about arguments for dotnet run without --. Update file-based apps reference article #50604 (comment)
• --no-cache isn't needed with dotnet build file.cs Update file-based apps reference article #50604 (comment)

Page URL

https://learn.microsoft.com/en-us/dotnet/core/sdk/file-based-apps

Content source URL

https://github.com/dotnet/docs/blob/main/docs/core/sdk/file-based-apps.md

Document Version Independent Id

d03da876-f782-a111-02b5-b87b2cedad11

Platform Id

bd9ae45e-1b55-0e01-0514-29c5f6c34d94

Article author

@gewarren

Metadata

• ID: 646ac25f-6d99-4dfe-e8b3-d7de28a502ae
• PlatformId: bd9ae45e-1b55-0e01-0514-29c5f6c34d94
• Service: dotnet-fundamentals

Related Issues

---

Associated WorkItem - 540968</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes Clarify information in file-based apps #50713

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

---

Internal previews

📄 File	🔗 Preview link
docs/core/sdk/file-based-apps.md	File-based apps

[Copilot]

Pull request overview

This PR addresses technical inaccuracies and missing clarifications in the file-based apps documentation based on PR review feedback. The changes improve accuracy around package versioning requirements, argument passing behavior, included file types, and build caching options.

Key changes:

• Adds clarification that versionless package references require central package management
• Removes incorrect documentation suggesting arguments can be passed without the -- separator
• Clarifies that ResX files are only included by non-default SDKs