Skip to content

Document .runtimeconfig.dev.json configProperties precedence change in .NET 11#54643

Draft
gewarren with Copilot wants to merge 4 commits into
mainfrom
copilot/breaking-change-config-properties-override
Draft

Document .runtimeconfig.dev.json configProperties precedence change in .NET 11#54643
gewarren with Copilot wants to merge 4 commits into
mainfrom
copilot/breaking-change-config-properties-override

Conversation

Copilot AI commented Jul 5, 2026

Copy link
Copy Markdown
Contributor

This PR documents a .NET 11 Preview 6 behavioral change: when the same configProperties key exists in both .runtimeconfig.json and .runtimeconfig.dev.json, the .runtimeconfig.dev.json value now takes precedence.

  • New breaking-change article (Deployment / .NET 11)

    • Added docs/core/compatibility/deployment/11/runtimeconfigdev-configproperties-precedence.md.
    • Captures previous behavior, new behavior, reason for change, recommended action, and affected APIs (None).
  • Compatibility navigation updates

    • Added the new article under Deployment in docs/core/compatibility/11.md.
    • Added the matching TOC node in docs/core/compatibility/toc.yml under .NET 11 > Deployment.
  • Related runtime-config guidance update

    • Updated docs/core/runtime-config/index.md to explicitly note the new precedence rule and link to the breaking-change article.
// app.runtimeconfig.json
{
  "runtimeOptions": {
    "configProperties": {
      "System.GC.Concurrent": true
    }
  }
}
// app.runtimeconfig.dev.json
{
  "runtimeOptions": {
    "configProperties": {
      "System.GC.Concurrent": false
    }
  }
}

With .NET 11 Preview 6+, the effective value is false from .runtimeconfig.dev.json.

Copilot AI requested review from Copilot and removed request for Copilot July 5, 2026 17:47
Copilot AI requested review from Copilot and removed request for Copilot July 5, 2026 17:50
Copilot AI requested review from Copilot and removed request for Copilot July 5, 2026 17:51
Copilot AI changed the title [WIP] Fix configProperties precedence in runtimeconfig files Document .runtimeconfig.dev.json configProperties precedence change in .NET 11 Jul 5, 2026
Copilot AI requested a review from gewarren July 5, 2026 17:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Breaking change]: configProperties specified in .runtimeconfig.dev.json override those in .runtimeconfig.json

2 participants