Fix wrong order for default configuration

[rufer7]

Summary

This pull request includes a minor reordering of the configuration providers list in the docs/core/extensions/configuration.md file. The change ensures that the appsettings.json configuration provider is listed after the appsettings.*Environment*.json provider for better clarity and alignment with the intended configuration precedence.

Key change:

• docs/core/extensions/configuration.md: Reordered the appsettings.json entry to follow the appsettings.*Environment*.json entry in the list of configuration providers. This change ensures the order reflects the configuration precedence more accurately.

---

Internal previews

📄 File	🔗 Preview link
docs/core/extensions/configuration.md	Configuration in .NET

[IEvangelist]

This is inaccurate. The order is correct as documented. See the source code, the order a provider is added is the order:

https://github.com/dotnet/runtime/blob/d221687c3724d26d653d022f4b254bc1d7eb1a6b/src/libraries/Microsoft.Extensions.Hosting/src/HostingHostBuilderExtensions.cs#L242-L243

[rufer7]

@IEvangelist hmm... I still think my suggested change is accurate. Let me please explain why.

The documentation states the following right above the list.

The <xref:Microsoft.Extensions.Hosting.Host.CreateApplicationBuilder(System.String[])?displayProperty=nameWithType> method provides default configuration for the app in the following order, from highest to lowest priority:

So based on the current version of the docs, appsettings.json would take precedence over appsettings.Environment.json which is wrong based on the link you pasted as .AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true, reloadOnChange: reloadOnChange); is added AFTER .AddJsonFile("appsettings.json", optional: true, reloadOnChange: reloadOnChange).

Furthermore, in the docs there is the following example right after the list which would match the suggested change as well as the expected behavior.

Adding a configuration provider overrides previous configuration values. For example, the [Command-line configuration provider](configuration-providers.md#command-line-configuration-provider) overrides all values from other providers because it's added last. If `SomeKey` is set in both *appsettings.json* and the environment, the environment value is used because it was added after *appsettings.json*.

[DarioErismann]

@IEvangelist I completely agree with @rufer7. According to the source code you shared, appsettings.json is added BEFORE appsettings.Environment.json.
This means that appsettings.json has the LOWER priority.

[rufer7]

@IEvangelist can you please revisit this PR?

[BillWagner]

ping @IEvangelist