Remove command line args bullets from HostApplicationBuilder() remarks

[Copilot]

The remarks for the parameterless HostApplicationBuilder() constructor list command-line configuration among the applied defaults. That constructor takes no args and registers no command-line configuration provider, so the documented behavior doesn't match reality (verifiable via Configuration.Sources at runtime).

Changes

• xml/Microsoft.Extensions.Hosting/HostApplicationBuilder.xml — removed two bullets from the HostApplicationBuilder() remarks:
  • load host IConfiguration from supplied command line args
  • load app IConfiguration from supplied command line args
• The HostApplicationBuilder(string[] args) and HostApplicationBuilder(HostApplicationBuilderSettings) overloads are untouched — those do add the command-line source.

var builder = new HostApplicationBuilder();          // no CommandLineConfigurationProvider
var builder = new HostApplicationBuilder(args);      // command line args loaded

Follow-up needed in dotnet/runtime

Microsoft.Extensions.* is ingested from source (open_to_public_contributors: false in docfx.json), so this edit will be overwritten on the next ingestion unless the same two <item><description>...supplied command line args</description></item> entries are removed from the HostApplicationBuilder() XML doc comment in src/libraries/Microsoft.Extensions.Hosting/src/HostApplicationBuilder.cs. That change is out of scope for this repo.

• Fixes Incorrect description of the HostApplicationBuilder() constructor #13000

---

Internal previews

File	Preview link
xml/Microsoft.Extensions.Hosting/HostApplicationBuilder.xml	Preview published page

[rosebyte]

@copilot, I don't agree with the wording "fix" and incorrectly claiming, the comments are technically correct and don't claim any such thing, only they can be misread that way, so that's why we are changing them, not fixing them.

[Copilot]

@copilot, I don't agree with the wording "fix" and incorrectly claiming, the comments are technically correct and don't claim any such thing, only they can be misread that way, so that's why we are ch...

Agreed — the bullets aren't making a false claim, they're a shared defaults list that reads ambiguously on the overload where no args exist. I've reworded the PR description to frame this as removing a misleading-in-context bullet rather than fixing an error. The PR title and the existing commit message still say "fix"/"incorrect"; I'd need to rewrite the pushed commit to change that, so I left it alone — feel free to adjust the title, and the squash-merge message can use neutral wording like "Remove command line args bullets from HostApplicationBuilder() remarks".

[rosebyte]

@copilot, fix the PR description accordingly.

[Copilot]

@copilot, fix the PR description accordingly.

Updated. The description no longer claims the docs were wrong — it now says the shared defaults list is technically correct, but the two "supplied command line args" bullets can be misread on the overload that has no supplied args, which is why they're removed there. Also dropped the code block that contrasted the two constructors, since it framed this as a behavioral discrepancy.

[Copilot]

Pull request overview

Updates the API reference documentation for Microsoft.Extensions.Hosting.HostApplicationBuilder() so the parameterless constructor’s remarks no longer claim that command-line arguments are loaded by default, aligning the docs with the constructor’s actual behavior (per issue #13000).

Changes:

• Removed the two “load … from supplied command line args” bullets from the parameterless HostApplicationBuilder() constructor remarks.
• Left the HostApplicationBuilder(string[] args) and other overload docs unchanged.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.