Microsoft.Extensions.Configuration.ConfigurationManager summary is out of date wrt XML doc comment

[KalleOlaviNiemitalo]

The summary on the ConfigurationManager Class (Microsoft.Extensions.Configuration) | Microsoft Learn page contains this:

Once IConfigurationBuilder.Build() is called, the configuration is frozen.

However, that sentence was deleted from the XML documentation comment in ConfigurationManager.cs in dotnet/runtime#62209, before the .NET 7.0.0 release. As far as I can tell, the sentence has never been true; when ConfigurationManager was first added in dotnet/runtime#55338, the implementation already had IConfigurationRoot IConfigurationBuilder.Build() => this;, which does not freeze anything.

Is xml/Microsoft.Extensions.Configuration/ConfigurationManager.xml maintained manually, or is some automated process expected to import the XML doc comment changes?

I couldn't figure out the best area label to add to this issue. If you have write-permissions please help me learn by adding exactly one area label.

Tagging subscribers to this area: @dotnet/area-extensions-configuration
See info in area-owners.md if you want to be subscribed.

Issue Details

---

The summary on the ConfigurationManager Class (Microsoft.Extensions.Configuration) | Microsoft Learn page contains this:

Once IConfigurationBuilder.Build() is called, the configuration is frozen.

However, that sentence was deleted from the XML documentation comment in ConfigurationManager.cs in dotnet/runtime#62209, before the .NET 7.0.0 release. As far as I can tell, the sentence has never been true; when ConfigurationManager was first added in dotnet/runtime#55338, the implementation already had IConfigurationRoot IConfigurationBuilder.Build() => this;, which does not freeze anything.

Is xml/Microsoft.Extensions.Configuration/ConfigurationManager.xml maintained manually, or is some automated process expected to import the XML doc comment changes?

Author:	KalleOlaviNiemitalo
Assignees:	-
Labels:	untriaged, Pri3, area-Extensions-Configuration
Milestone:	-

[tarekgh]

Is xml/Microsoft.Extensions.Configuration/ConfigurationManager.xml maintained manually, or is some automated process expected to import the XML doc comment changes?

This needs to be fixed manually. Are you interested in submitting a PR for it?

CC @carlossanlop