Skip to content

Document PublishRuntimeIdentifier in the .NET SDK MSBuild property reference#53878

Open
Copilot wants to merge 12 commits into
mainfrom
copilot/document-publishruntimeidentifier-property
Open

Document PublishRuntimeIdentifier in the .NET SDK MSBuild property reference#53878
Copilot wants to merge 12 commits into
mainfrom
copilot/document-publishruntimeidentifier-property

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented May 18, 2026

The MSBuild property reference listed publish-time properties but didn't document PublishRuntimeIdentifier, a publish-scoped alternative to RuntimeIdentifier. This update adds that missing guidance and clarifies how the property behaves during publish.

  • Docs update

    • Added PublishRuntimeIdentifier to the publish-related property index in docs/core/project-sdk/msbuild-props.md.
    • Added a dedicated section describing it as a publish-only RID property.
  • Behavior clarified

    • Notes that the property was introduced in .NET 7.
    • Explains that it doesn't affect build operations.
    • Clarifies that during publish, PublishRuntimeIdentifier sets RuntimeIdentifier.
    • Notes that a globally passed RuntimeIdentifier still takes precedence.
  • Usage example

    • Added an XML example showing how to set the property in a project file.
<PropertyGroup>
  <PublishRuntimeIdentifier>linux-x64</PublishRuntimeIdentifier>
</PropertyGroup>

Internal previews

📄 File 🔗 Preview link
docs/core/project-sdk/msbuild-props.md docs/core/project-sdk/msbuild-props

Copilot AI self-assigned this May 18, 2026
Copilot AI review requested due to automatic review settings May 18, 2026 18:18
Copilot AI review requested due to automatic review settings May 18, 2026 18:18
Copilot AI linked an issue May 18, 2026 that may be closed by this pull request
Agent-Logs-Url: https://github.com/dotnet/docs/sessions/35022049-3a8b-47bd-b7b3-e14da5bc5689

Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Copilot AI requested review from Copilot and removed request for Copilot May 18, 2026 18:19
Agent-Logs-Url: https://github.com/dotnet/docs/sessions/35022049-3a8b-47bd-b7b3-e14da5bc5689

Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Copilot AI requested review from Copilot and removed request for Copilot May 18, 2026 18:20
Agent-Logs-Url: https://github.com/dotnet/docs/sessions/35022049-3a8b-47bd-b7b3-e14da5bc5689

Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Copilot AI requested review from Copilot and removed request for Copilot May 18, 2026 18:21
Agent-Logs-Url: https://github.com/dotnet/docs/sessions/35022049-3a8b-47bd-b7b3-e14da5bc5689

Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Copilot AI requested review from Copilot and removed request for Copilot May 18, 2026 18:21
Agent-Logs-Url: https://github.com/dotnet/docs/sessions/35022049-3a8b-47bd-b7b3-e14da5bc5689

Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Copilot AI requested review from Copilot and removed request for Copilot May 18, 2026 18:22
Agent-Logs-Url: https://github.com/dotnet/docs/sessions/35022049-3a8b-47bd-b7b3-e14da5bc5689

Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Copilot AI requested review from Copilot and removed request for Copilot May 18, 2026 18:23
Agent-Logs-Url: https://github.com/dotnet/docs/sessions/35022049-3a8b-47bd-b7b3-e14da5bc5689

Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Copilot AI requested review from Copilot and removed request for Copilot May 18, 2026 18:23
Agent-Logs-Url: https://github.com/dotnet/docs/sessions/35022049-3a8b-47bd-b7b3-e14da5bc5689

Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Copilot AI requested review from Copilot and removed request for Copilot May 18, 2026 18:24
Agent-Logs-Url: https://github.com/dotnet/docs/sessions/35022049-3a8b-47bd-b7b3-e14da5bc5689

Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Copilot AI requested review from Copilot and removed request for Copilot May 18, 2026 18:24
Agent-Logs-Url: https://github.com/dotnet/docs/sessions/35022049-3a8b-47bd-b7b3-e14da5bc5689

Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Copilot AI requested review from Copilot and removed request for Copilot May 18, 2026 18:25
Copilot AI requested review from Copilot and removed request for Copilot May 18, 2026 18:25
Copilot AI changed the title [WIP] Add documentation for 'PublishRuntimeIdentifier' property Document PublishRuntimeIdentifier in the .NET SDK MSBuild property reference May 18, 2026
Copilot AI requested a review from gewarren May 18, 2026 18:26
@gewarren gewarren marked this pull request as ready for review May 18, 2026 18:33
@gewarren gewarren requested a review from a team as a code owner May 18, 2026 18:33
Copilot AI review requested due to automatic review settings May 18, 2026 18:33
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the .NET SDK MSBuild property reference to document PublishRuntimeIdentifier as a publish-scoped alternative to RuntimeIdentifier, including a short description of publish-time behavior and a project-file example.

Changes:

  • Added PublishRuntimeIdentifier to the publish-related property index.
  • Added a new PublishRuntimeIdentifier section explaining publish-only behavior, precedence, and the .NET version it was introduced in.
  • Added an XML example showing how to set PublishRuntimeIdentifier in a project file.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document the 'PublishRuntimeIdentifier' property

3 participants